Skill lint & preview
Statically check YAML front matter, required fields, and step numbering before you ship a SKILL, and preview rendering locally to catch formatting issues early.
Wire into pre-commit or CI: rules mirror your authoring guide, with copy-paste fixes when checks fail.
Preview focuses on headings, code fences, and boundary notes for model consumption.
Version rulesets: when the authoring guide bumps, bump the ruleset version so CI logs show whether content stayed the same or checks got stricter. For huge repos, use path globs to vary strictness.
- Local: fast feedback for authors.
- CI: pairs with branch protection against bypassed hooks.
- Preview: language tags on fences and long lines that confuse models.
# Example checks
- name / description present
- Step numbers contiguous
- No unreplaced placeholders