Constraints {
  require {
    Verify before committing — run frontmatter check, structure check, word count
    Define clear output format in every skill
    Test discipline-enforcing skills with pressure scenarios (3+ combined pressures)
    Use imperative steps, not declarative statements
  }
  never {
    Create a skill without checking for existing duplicates first — if >50% overlap, update existing skill
    Commit a skill without verification (frontmatter check, structure check, test)
    Write declarative-only skills — workflow steps must be imperative
    Summarize workflow in the description — description is for triggers only, not execution
    Skip testing with "I can see the fix is correct" or "it's just a small change" — analysis != verification
    Create skills over 500 lines — extract to reference.md
  }
}

undefined

**If similar skill exists:**
- Propose updating existing skill instead
- Or explain why new skill is justified

**Rationalization trap:** "Mine is different enough" — if functionality overlaps >50%, update the existing skill.

---
name: kebab-case-name                    # Lowercase, numbers, hyphens (max 64 chars)
description: What it does and when to use it  # Max 1024 chars
allowed-tools: Tool1, Tool2              # Tools without permission prompts (optional)
disable-model-invocation: false          # true = only user can invoke (optional)
user-invocable: true                     # false = hides from / menu (optional)
context: fork                            # Run in subagent (optional)
agent: Explore                           # Subagent type when context: fork (optional)
---

undefined

**Body structure:**

```markdown

**Size targets:**
- Keep SKILL.md under 500 lines
- Move heavy reference to separate files
- Use progressive disclosure

**String substitutions (for dynamic content):**
```yaml
$ARGUMENTS         # All arguments passed when invoking
$ARGUMENTS[0]      # First argument (or use $0 shorthand)
${CLAUDE_SESSION_ID}  # Current session ID
!`shell command`   # Execute command, insert output (preprocessing)

undefined

**For discipline-enforcing skills:** Run a pressure scenario with subagent to verify agents comply. See **testing-with-subagents.md** for full methodology (RED-GREEN-REFACTOR for skills).

---

undefined

undefined

The security review should check for SQL injection vulnerabilities.

undefined

undefined

allowed-tools: Task, Bash, Read
---
[skill body never mentions how to use tools]

allowed-tools: Task, Bash, Read
---

undefined

description: Coordinates code review by launching four specialized subagents then synthesizing findings

description: Use when reviewing code changes, PRs, or staged files. Handles security, performance, quality, and test analysis.

| Excuse | Reality |
|--------|---------|
| "Just this once" | Exceptions become habits. No exceptions. |
| "It's obvious" | Obvious to you ≠ clear to agents. Test it. |

undefined

**Test with pressure scenarios:**
Use 3+ combined pressures (time + sunk cost + exhaustion). See **testing-with-subagents.md**.

---