---
name: your-skill-name
description: "One-line description of what this skill does and when to use it"
version: "0.1.5"
category: development
tags: [example-tag-1, example-tag-2]
complexity: intermediate
risk: safe
tools: [claude-code, cursor, gemini-cli, antigravity]
source: community
author: "Your Name"
date_added: "2026-01-01"
date_updated: "2026-01-01"
---

<!--
Use a canonical category such as:
development, frontend, backend, fullstack-web, tools, cli-automation,
business, product, design, data-ai, ai-agents, machine-learning, devops,
testing-security, documentation, content-media, communication, uncategorized.

`npm run validate` will generate skills/<skill>/metadata.json with canonical
taxonomy, maturity level, best practices score, quality score, and security
scan results. Prompt-injection patterns, destructive commands, and risky script
constructs will be flagged automatically.

The skill version is independent from the package version. Use the semantic
version that makes sense for the skill itself.

For a top-scoring skill, also read:
- docs/contributors/HIGH-SCORE-PLAYBOOK.md
- docs/contributors/QUALITY-BAR.md
-->

# Skill Title

## Overview

2-3 sentences explaining what this skill does, who benefits from it, and why it exists.

## When to Use This Skill

- Use when you need to [scenario 1]
- Use when you want to [scenario 2]
- Use when working with [scenario 3]

## Core Concepts

### Concept 1

Explain the key concept the agent needs to understand.

### Concept 2

Explain another foundational concept.

## Workflow

| Phase | Output | Why it matters |
|:------|:-------|:---------------|
| Frame the goal | Clear objective | Prevents vague guidance |
| Execute the steps | Agent-ready workflow | Makes the skill actionable |
| Validate the output | Acceptance signal | Raises confidence |

1. First step in the workflow
2. Second step in the workflow
3. Third step in the workflow

### 1. First Step

Detailed instructions for the first step.

### 2. Second Step

Detailed instructions for the second step.

### 3. Third Step

Detailed instructions for the third step.

## Examples

### Example 1: Common Use Case

```
Example prompt or code here
```

**Explanation:** What this example demonstrates.

### Example 2: Advanced Use Case

```
More advanced example
```

**Explanation:** What this example demonstrates.

## Best Practices

- ✅ **Do:** Follow this good practice
- ✅ **Do:** Also follow this practice
- ❌ **Don't:** Avoid this antipattern
- ❌ **Don't:** Never do this

## Troubleshooting

### Problem: Common Issue

**Symptoms:** How you know this is the problem.
**Solution:** How to fix it.

## Related Skills

- `@related-skill-1` — When to use this instead
- `@related-skill-2` — How this complements your skill

## Additional Resources

- [Checklist](references/checklist.md)
- [Worked example](examples/example.md)
- [Helper script](scripts/render_example.py)