Jeff Smolinski b4da351dbf refine Description Trap: permit capability verbs, prohibit process steps ...

The original Description Trap (from obra/superpowers research) warned
specifically about process steps leaking into descriptions. The project
over-generalized this into a trigger-only rule that also excluded
capability verbs. This aligns the guidance with the AgentSkills.io spec
which recommends describing both what a skill does and when to use it.

- CLAUDE.md: narrow Description Trap, update format template and examples
- MODELCLAUDE.md: matching update to Description Trap section
- validate-skills.py: change startswith to contains check for "Use when"
- CHANGELOG.md: document changes under [Unreleased]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-06 15:18:21 -06:00

..

migrate-frontmatter.py

apply Ruff + Prettier formatting to codebase

2026-02-24 22:09:33 -06:00

test-makefile.sh

feat(workflow): add YAML workflow definitions, DAG manifest, and phase documentation

2026-02-01 13:41:32 -06:00

update-docs.py

fix stale counts on docs landing page, add astro files to release automation

2026-03-01 07:45:15 -06:00

validate-markdown.py

apply Ruff + Prettier formatting to codebase

2026-02-24 22:09:33 -06:00

validate-skills.py

refine Description Trap: permit capability verbs, prohibit process steps

2026-03-06 15:18:21 -06:00