# Project-specific skills (version controlled)
mkdir -p .claude/skills/my-skill

# Personal skills (all projects)
mkdir -p ~/.claude/skills/my-skill

---
name: my-skill
description: What this skill does and when to use it
---

Your instructions here...

my-skill/
├── SKILL.md           # Required: Main instructions
├── reference.md       # Optional: Detailed docs
├── examples.md        # Optional: Usage examples
├── template.txt       # Optional: Template for Claude
└── scripts/
    └── helper.py      # Optional: Executable scripts

---
name: my-skill
description: Detailed description of what this skill does
disable-model-invocation: true
user-invocable: true
allowed-tools: Read, Grep, Bash
model: sonnet
context: fork
agent: Explore
argument-hint: [argument1] [argument2]
hooks:
  PreToolUse: ./pre-tool-hook.sh
---

---
name: fix-issue
description: Fix a GitHub issue
---

Fix GitHub issue $ARGUMENTS following our coding standards.

---
name: pr-summary
description: Summarize changes in a pull request
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`

Summarize this pull request...

---
name: safe-reader
description: Read files without making changes
allowed-tools: Read, Grep, Glob
---

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly...

---
name: my-skill
hooks:
  PreToolUse: ./validate-before-running.sh
---

---
name: complex-analyzer
description: Deep analysis with extended thinking
---

Perform ultrathink analysis of...

# Good: Specific and action-oriented
description: Explains code with visual diagrams and analogies. Use when explaining how code works, teaching a codebase, or answering "how does this work?"

# Poor: Too vague
description: Code explanation skill

---
name: api-conventions
description: API design patterns for this codebase
disable-model-invocation: false
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

1. Run the test suite
2. Build the application
3. Push to deployment

## Additional resources

- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)

{
  "permissions": {
    "deny": [
      "Skill(deploy:*)"
    ]
  }
}

---
name: commit-helper
description: Help write better commits
allowed-tools: Bash(git:*)
---

## Repository state
- Current branch: !`git rev-parse --abbrev-ref HEAD`
- Changed files: !`git diff --name-only`
- Current status: !`git status --short`

Help me write a conventional commit message...

---
name: research-and-report
description: Research and generate report
context: fork
agent: Explore
---

1. Research $ARGUMENTS thoroughly
2. Find relevant code and documentation
3. Generate findings report