Good Skill
This is a minimal but compliant SKILL.md.
Common Rationalizations
| Rationalization | Why it's wrong |
|---|---|
| "Skipping tests is fine for fixtures" | Fixtures themselves prove the invariant works; skipping them voids the contract. |
| "The skill is too small to need a tail block" | Convention applies regardless of size. |
| "I'll add the tail block later" | Later never comes; convention requires it now. |
Red Flags
- Frontmatter is missing required keys.
- A SKILL.md cites
references/<file>.mdthat does not exist. - A skill declares
user_invocable: truebut ships no tail block.
Verification
assert_frontmatter_parsesreturns a dict.assert_required_keys_presentdoes not raise.assert_tail_block_presentdoes not raise.