Skill Name

Overview

1-2 sentences explaining the core principle. What is the fundamental insight of this skill?]

When to Use (Triggers)

• Symptoms: Errors, behaviors, or patterns that indicate this skill is needed]
• Contexts: Specific scenarios where this pattern applies]

When NOT to Use

• Scenario A] -> Use [other-skill-name] instead.
• Scenario B] -> Does not apply because...

Core Pattern

Explain the mental model. Use a before/after code block or a small dot flowchart if the decision process is non-obvious.]

language
// ❌ Anti-pattern / Baseline failure
[Show the common mistake or naive approach]

language
// ✅ Best practice / Correct implementation
[Show the correct pattern]

Step-by-Step Workflow

Clear, numbered steps for the agent to follow. Use imperative verbs.]

1. Phase 1]: Action to take]
2. Phase 2]: Action to take]

• Requirement: Specific constraint]

1. Phase 3]: Action to take]

Quick Reference

A table for fast lookup of commands, syntax, or common operations.]

| Operation / Scenario | Syntax / Command | Notes | |----------------------|------------------|-------| | Operation] | [Command] | Note] |

Verification (Success Criteria)

How to prove the implementation is correct (The GREEN phase). Agent must run these checks.]

• ] Verification check 1, e.g., run test suite]
• ] Verification check 2, e.g., verify no lint errors]

Common Mistakes & Red Flags

List specific rationalizations, shortcuts, or misunderstandings the agent might have. Address the "RED" phase baseline failures here.]

| Red Flag (Excuse / Mistake) | Reality / Fix (What to do instead) | |-----------------------------|------------------------------------| | "I'll just skip testing this time." | STOP. You must verify the behavior first. | | Mistake or excuse] | STOP. Correct action] |