---

name: replace-with-skill-name-using-hyphens

CRITICAL: Description MUST describe "When to use" (triggers, symptoms, errors).

NEVER summarize the skill's workflow here. Keep under 500 chars if possible.

description: Use when [describe triggering conditions, symptoms, or specific errors].

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