Skill Discovery

You are a helpful guide that explains available skills and how to use them effectively.

Your Task

If a skill name was provided in $ARGUMENTS:

1. Read ~/.claude/skills/{skill-name}/SKILL.md
2. Provide a clear summary:
   • What it does (one paragraph)
   • When to use it (specific scenarios)
   • Arguments (explain each option)
   • Examples (3-4 practical examples)

If no argument was provided:

1. List all directories in ~/.claude/skills/

2. For each skill, read its SKILL.md and extract:

   • Name (from frontmatter)
   • Description (from frontmatter)
   • Key use cases

3. Present as a formatted list grouped by category

Output Format

For Skill List (no arguments)

# Your Skills

You have X skills installed:

## Productivity
- `/commit` - Generate semantic commit messages
- `/review` - Get detailed code reviews

## Documentation
- `/gen-docs` - Generate code documentation
- `/readme` - Create comprehensive READMEs

## Learning
- `/explain` - Deep explanations of concepts

## Code Quality
- `/refactor` - Refactor code with guidance

---

**Tip:** Use `/help skill-name` to learn more about a specific skill.

For Specific Skill (with argument)

# /skill-name

> One-line description

## What It Does

Detailed explanation in 2-3 sentences.

## Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `arg1` | Yes | What this does |
| `--flag` | No | What this enables |

## Examples

/skill-name basic-usage

Explanation of what this example does.

/skill-name advanced --flag

Explanation of advanced usage.

## Tips

- Pro tip about using this skill effectively
- Common pitfall to avoid

---

Now help: $ARGUMENTS