Use this skill whenever the user asks to lint, audit, validate, or review an agent skill package, especially for SKILL.md/frontmatter checks, broken local links, missing bundled references, stale metadata, or packaging consistency across .agents/skills or ~/.agents/skills. Also use it when the user asks whether a skill is packaged correctly, wants a report-only pass, or wants a repo script/test for skill validation.
This skill helps audit agent skills for packaging correctness.
It is optimized for:
.agents/skills/ or ~/.agents/skills/SKILL.md, frontmatter, bundled references, and local markdown linksStart with a read-only, report-only lint pass unless the user explicitly asks for fixes.
When asked to lint a skill:
Use the repo lint script first:
npm run lint:skillsnpm run lint:skills -- .agents/skills/pi-sdk-docsnpm run lint:skills -- --jsonThe implementation lives at:
scripts/lint-skills.tssrc/skill-lint.tstest/skill-lint.test.tsSKILL.md existssources.md exists, its referenced packaged paths existCheck for:
namedescriptionlicense if the repo expects itCheck for:
reference/..., references/..., scripts/..., assets/..., or sources.mdLook for signs that the skill was moved or refreshed incompletely, for example:
Keep the report concise and structured:
If there are no issues, say so clearly.
Only move from linting to edits if the user asks.
When fixing: