Unify the framing across the verification note, rationalization row,
and red flag entry in both incremental-implementation and
test-driven-development skills. The previous wording mixed "once per
increment" (correct) with "no additional value after success" (only
true if nothing has changed), which an agent could read as "skip
verification entirely after one success."
The unified rule: after a successful run, don't repeat the same
command unless the code has changed since.
Fixes#47
## Changes
- Add verification guidance to incremental-implementation skill checklist
- Add test guidance to test-driven-development skill verification section
- Add common rationalizations about redundant verification in both skills
- Add red flags for running same command multiple times after success
## Impact
This addresses the issue where agents run build verification commands (npx tsc --noEmit, npx vite build, npm test) multiple times consecutively after successful runs, providing clear guidance to trust the first successful verification.
Update all SKILL.md descriptions to lead with what the skill does
(third person) followed by trigger conditions, per Anthropic's
skill authoring docs. All original trigger conditions preserved.
Update description max chars to match Anthropic spec (1024).
Retain workflow-summary warning in skill-anatomy.md to prevent
agents from following descriptions instead of reading full skills.
Add Table of Contents to reference files longer than 100 lines so
Claude can see the full scope of available information even when
previewing with partial reads.
Anthropic's Claude 4 prompting best practices document warns that
newer models overtrigger on strong directive language (Never/Always/MUST)
that was necessary for older models. This replaces aggressive directives
with natural phrasing across skills and agents while preserving all
security-critical rules (OWASP, prompt injection, secrets) unchanged.
Also reframes trunk-based development as "Recommended" with a note
acknowledging alternative branching strategies like gitflow.
Build phase skills covering thin vertical slices and
production-quality UI development patterns.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Addy Osmani