skill-auditor
Audits skills in this repo for consistency, API drift, and structural gaps. Produces a prioritized report grouped by severity (Critical/High/Medium/Low). Use when asked to "audit skills", "check the skill repo for drift", or when planning bulk skill cleanup. Read-only — does not apply fixes.
npx skills add rshankras/claude-code-apple-skills --skill skill-auditor --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Skill Auditor Audits every `SKILL.md` in `skills/` for frontmatter correctness, structural completeness, API/version drift, and cross-file reference integrity. Produces a prioritized markdown report. Read-only — never applies fixes. ## When This Skill Activates Use this skill when the user: - Says "audit skills", "audit my skills", "run the skill auditor" - Asks to "check the skill repo for drift", "review skills for consistency" - Says "find broken skills", "validate skill frontmatter" - Is planning a bulk cleanup of the skill repo - References a specific category to audit (e.g., "audit the generators/ skills") **Does NOT activate** for: creating new skills (use `skill-creator`), applying fixes (follow-up flow after this auditor reports), or auditing Swift code inside skills (use `ios/coding-best-practices` or `macos/coding-best-practices`). ## Scope Resolve the invocation argument in this order: 1. **No argument** → audit all of `skills/**/SKILL.md` 2. **Category path** (e.g., `generators/`, `ios/`) → audit `skills/<arg>/**/SKILL.md` 3. **Single file path** (e.g., `skills/liquid-glass/SKILL.md`) → audit one file 4. **Fuzzy match** → if arg doesn't resolve, try `skills/<arg>/SKI
- When This Skill Activates
- Scope
- Process
- 1. Enumerate
- 2. Parse Frontmatter (Cached)
- 3. Run Checks
- 4. Classify Aggregator vs Leaf
- 5. Rank and Emit
- Checks
- 🔴 Critical
- 🟠 High
- 🟡 Medium
- 🟢 Low
- Aggregator vs Leaf Detection
What does the skill-auditor skill do?
Audits skills in this repo for consistency, API drift, and structural gaps. Produces a prioritized report grouped by severity (Critical/High/Medium/Low). Use when asked to "audit skills", "check the skill repo for drift", or when planning bulk skill cleanup. Read-only — does not apply fixes.
How do I install it?
Run `npx skills add rshankras/claude-code-apple-skills --skill skill-auditor --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From rshankras/claude-code-apple-skills, a repository with 589 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.