Template

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

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