audit-skill — Claude Code command: audit skills
audit-skill is a Claude Code command that checks a skill against YAML, XML, and progressive disclosure requirements before structural changes or publication.
MIT ★ 1,988 updated 2026-04-01
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resourcesWhat audit-skill does
The command invokes the skill-auditor subagent and passes it the target skill path. The audit covers pure XML structure, required and conditional tags, progressive disclosure, and common anti-patterns. Its findings include file-and-line locations, compliance scores, and recommendations.
The command expects <skill-path> as its argument, so the subagent cannot audit a target without that path. It also checks that the subagent was invoked and received the argument correctly. In Claude Code, install it through the taches-cc-resources marketplace.
What it helps with
- check a skill’s YAML against the required format
- review the quality of its XML structure
- spot missing required or conditional tags
- find anti-patterns in a skill definition
- inspect findings with file-and-line locations
Example prompts for the agent
- Audit
skills/review/SKILL.mdagainst Agent Skills best practices. - Run
/taches-cc-resources:audit-skill skills/review/SKILL.mdand show XML structure issues. - Review
skills/data/SKILL.mdwith special attention to progressive disclosure.
How to install audit-skill
1Plugin marketplace
/plugin marketplace add glittercowboy/taches-cc-resources/plugin install taches-cc-resources@taches-cc-resources2Manually: put the files in place
.claude/commands/audit-skill.mdCall it with /audit-skill. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/audit-skill.mdCall it with /prompts:audit-skill. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/audit-skill.prompt.mdManually: put the files in place
.gemini/commands/audit-skill.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about audit-skill
How do I install audit-skill in Claude Code?
Add the marketplace with /plugin marketplace add glittercowboy/taches-cc-resources, then install the plugin with /plugin install taches-cc-resources@taches-cc-resources.
What does audit-skill do?
It sends the selected skill path to the skill-auditor subagent. The subagent reviews YAML, XML structure, tags, progressive disclosure, and anti-patterns, then returns scores and recommendations.
What argument does audit-skill require?
Pass the skill location as <skill-path>. Without that argument, the subagent has no audit target.
Source text
audit-skill.md · MIT
--- description: Audit skill for YAML compliance, pure XML structure, progressive disclosure, and best practices argument-hint: <skill-path> --- <objective> Invoke the skill-auditor subagent to audit the skill at $ARGUMENTS for compliance with Agent Skills best practices. This ensures skills follow proper structure (pure XML, required tags, progressive disclosure) and effectiveness patterns. </objective> <process> 1. Invoke skill-auditor subagent 2. Pass skill path: $ARGUMENTS 3. Subagent will read updated best practices (including pure XML structure requirements) 4. Subagent evaluates XML structure quality, required/conditional tags, anti-patterns 5. Review detailed findings with file:line locations, compliance scores, and recommendations </process> <success_criteria> - Subagent invoked successfully - Arguments passed correctly to subagent - Audit includes XML structure evaluation </success_criteria>
© Lex Christopherson · MIT · glittercowboy/taches-cc-resources