replace-with-skill-name-using-hyphens

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.]

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

// ✅ 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] |