Skill Warden

SkillDocs & knowledge

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

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Skill Warden skill

What this skill tells your AI

The instructions your AI receives, as published by mphinance/alpha-skills in skills/skill-warden/SKILL.md and read by ahel’s review.

"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

  1. Dead Skill Detection: Scans for skills that haven't been invoked in the last 30 days or lack proper SKILL.md formatting.
  2. 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.
  3. Conflict Resolution: Identifies duplicate trigger phrases across different skills.
  4. 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":

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

Signals

GitHub stars
27
Forks
5
Last commit
Sep 2026
Advanced
Item type
skill
Key
skill-warden
Source
github.com/mphinance/alpha-skills