skill-auditor
Skill Auditor
Quick start
node skill-auditor/scripts/audit.mjs <path-to-skill-or-directory>
Examples:
node skill-auditor/scripts/audit.mjs epic-workflow
node skill-auditor/scripts/audit.mjs epic-workflow/SKILL.md
node skill-auditor/scripts/audit.mjs .agents/skills/tdd
Workflow
- Run the script — outputs a pass/fail report for all mechanical checks
- Review flagged items — fix each
FAILin the SKILL.md - Content review — for each skill, manually check:
- First sentence describes what the skill does (capability, not intent)
- "Use when" triggers are specific enough to distinguish from similar skills
- No time-sensitive info (dates, version numbers, "currently", "now")
- At least one concrete example (not just abstract description)
- Any referenced files exist and are one level deep only
Checks performed by script
| Check | Rule |
|---|---|
| Frontmatter present | Must have --- block at top |
name field |
Required in frontmatter |
description field |
Required in frontmatter |
| Description length | ≤ 1024 characters |
| "Use when" present | Description must contain "Use when" |
| Line count | SKILL.md must be ≤ 100 lines |
More from costicapuntaru/agentica
opsx-apply-subagents
Orchestrates dependency-aware parallel subagents for OpenSpec workflows, supporting OPSX commands, legacy openspec commands, and Codex CLI prompt aliases. Use when running /opsx:apply, /openspec:apply, or any opsx command with multiple independent tasks that can be parallelized.
14write-a-prd
Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.
9epic-workflow
End-to-end Epic planning — grill requirements, write a PRD, decompose into GitHub issues with dependencies, and create a feature branch for autonomous implementation. Use when starting a new epic, planning a large feature, or when user says "epic workflow", "plan this feature", or "start a new epic".
8github-auto-implement
Autonomous GitHub issue implementation — picks the next ready issue, triages it, implements with TDD, and opens a PR targeting the correct branch (default, epic feature branch, or PR-chained dependency branch). Use when running the autobot daemon, implementing GitHub issues autonomously, or starting the auto-implement loop.
8tdd
Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
7grill-me
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
7