brooks-lint — New Skill Scaffold
Skill name comes from $ARGUMENTS (kebab-case, e.g. brooks-security). If empty,
ask for the name and a one-line purpose first.
Follow the repo's "Adding a New Skill" checklist exactly:
- Create
skills/{name}/SKILL.mdwith frontmatter —name, adescriptionthat ends with aDo NOT trigger for:clause (validate-enforced for shipped skills; omitting it causes false triggering), and aProcesssection of 3–6 bullets that cite the guide's step ranges inline (e.g.Scan risks (Steps 1–6 of the guide)). Mirror the structure of an existing skill such asskills/brooks-review/SKILL.md(Setup → Process → Mode line). - Create
skills/{name}/{name}-guide.mdwith sequentially numbered steps — no gaps, no duplicates. Sub-steps likeStep 2aare allowed. The guide owns the detailed steps; the SKILL.md Process is just an orientation skeleton. - Wire the framework. The new SKILL.md Setup section must Read the relevant
_shared/files (common.mdfor Iron Law + Report Template, plusdecay-risks.md/test-decay-risks.mdas applicable) —_shared/is NOT auto-loaded. - Add eval coverage to
evals/evals.json: append with the next sequentialidat least one happy-path scenario (with the relevant risk code inexpected_output) and at least one false-positive scenario flaggedno_risk_codes: true. Each scenario needsid,name,prompt,expected_output,mode,files. - Validate.
npm run validate(structure + step continuity + Process-section presence) andnpm run evals(eval schema). Fix until both pass. - Local-test.
cp -r skills/* ~/.claude/skills/brooks-lint/(if you've symlinked~/.claude/skills/brooks-lintto the repo, skip this — edits are already live), trigger the new skill in a Claude session, verify the Iron Law output, then restore the marketplace copy:/plugin marketplace update→/plugin install brooks-lint@brooks-lint-marketplace.
Do NOT register a slash command by hand — short forms are auto-installed by the session-start hook. Report the files created and the validate/evals results.