---
name: your-skill-name
description: [What it does] + [When to use it] + [Trigger terms users would say]. Max 1024 characters.
---

# Your Skill Name

Brief one-sentence description of what this Skill provides.

## Quick Start

Show the most common use case immediately:

```language
# Quick example that demonstrates the primary operation

# Code example for common scenario

# Code example for another scenario

# Installation commands
pip install package-name
npm install package-name

---

## Real Example: Git Commit Helper

Here's a complete working example:

```yaml
---
name: commit-helper
description: Generate conventional commit messages from git diffs. Use when writing commits, reviewing staged changes, or when the user asks for commit message help.
---

# Git Commit Helper

Generates clear, conventional commit messages following best practices.

## Quick Start

```bash
# Stage your changes first
git add .

# I'll review the diff and suggest a commit message
git diff --staged

feat: add user authentication

Implement JWT-based authentication to secure API endpoints.
Adds login/logout routes and token validation middleware.

fix: prevent duplicate form submissions

Add debouncing to submit button to prevent race conditions
when users double-click. Includes 500ms cooldown period.

refactor: extract validation logic to shared utilities

Move repeated validation code from 5 route handlers into
reusable validation functions. No behavior changes.

---

## Tips for Using This Template

1. **Replace all bracketed placeholders** with actual content
2. **Delete sections you don't need** - not every Skill needs all sections
3. **Add sections if needed** - templates are starting points, not constraints
4. **Keep it focused** - one Skill = one capability
5. **Test your examples** - verify all code examples actually work
6. **Be specific in descriptions** - use exact trigger terms users would say