skill-warden

Original：🇺🇸 English

Translated

Security scanner and health check for your AI agent skills tree. Identifies dead skills, missing documentation, and unsafe shell execution paths.

4installs

Sourcemphinance/alpha-skills

Added on2026-05-31

NPX Install

npx skill4agent add mphinance/alpha-skills skill-warden

SKILL.md Content

View Translation Comparison →

Skill Warden

"Trust, but verify."

With a repository containing over 100+ highly specialized agent skills, technical debt and security risks become non-trivial. Skill Warden automates the health and security audits of the

skills/

directory.

Core Directives

Dead Skill Detection: Scans for skills that haven't been invoked in the last 30 days or lack proper
```
SKILL.md
```
formatting.
Security Auditing: Parses shell commands embedded in skills. Flags any usage of destructive flags (e.g.,
```
rm -rf
```
,
```
--delete
```
with
```
rsync
```
) or unauthorized external API calls.
Conflict Resolution: Identifies duplicate trigger phrases across different skills.
Grading Matrix: Assigns a health score (0-100) to each skill based on documentation completeness, deterministic behavior, and safety constraints.

Usage

When invoked via "Run Skill Warden" or "Audit my skills":

Recursively read all
```
SKILL.md
```
files.
Generate a
```
skill_audit_report.md
```
artifact detailing warnings, critical errors, and a list of deprecated skills.
Await user confirmation before attempting auto-fixes or deletion of dead skills.