1my-skill/
2├── SKILL.md           # Main instructions (required)
3├── template.md        # Template for Claude to fill in
4├── examples/
5│   └── sample.md      # Example output showing expected format
6└── scripts/
7    └── validate.sh    # Script Claude can execute

1---
2name: deploy
3description: Deploy the application to production
4disable-model-invocation: true
5allowed-tools: Bash(npm *), Bash(git *)
6---
7 
8Deploy $ARGUMENTS to production:
9 
101. Run `npm test` — if any test fails, STOP
112. Run `npm run build`
123. Run `npm run deploy:prod`
134. Verify the deployment succeeded
145. Report the deployment URL
15 
16IMPORTANT: Get confirmation before deploying.
17NEVER: Deploy if tests are failing.

1---
2name: migrate-component
3description: Migrate a component from one framework to another
4---
5 
6Migrate the $0 component from $1 to $2.
7Preserve all existing behavior and tests.

/migrate-component SearchBar React Vue

1---
2name: api-conventions
3description: API design patterns for this codebase
4user-invocable: false
5---
6 
7When writing API endpoints:
8- Use RESTful naming conventions
9- Return consistent error formats using ApiResponse<T>
10- Validate all inputs with Zod schemas
11- Include authentication middleware on all routes

1---
2name: pr-ready
3description: Prepare changes for a pull request
4disable-model-invocation: true
5---
6 
7Prepare the current branch for PR:
8 
91. Run `npm run lint` — fix any issues
102. Run `npm test` — all must pass
113. Run `npm run build` — must succeed
124. Write a commit message following conventional commits
135. Push to remote with `git push -u origin HEAD`
146. Create PR with `gh pr create`
15 
16IMPORTANT: Stop and report if any step fails.

1---
2name: review
3description: Review current changes for bugs, security issues, and code quality
4disable-model-invocation: true
5allowed-tools: Bash(git diff*), Read, Grep, Glob
6---
7 
8Review the current changes:
9 
101. Run `git diff` to see all changes
112. For each file changed, analyze for:
12   - Logic errors and edge cases
13   - Security vulnerabilities (injection, auth, secrets)
14   - Performance issues (N+1 queries, memory leaks)
15   - Missing tests for new behavior
163. Provide feedback:
17 
18## Review Summary
19**Status:** Approved / Needs Changes
20 
21### Issues Found
22- **[severity]** Issue description (file:line)
23 
24### Suggestions
25- Improvement suggestions
26 
27IMPORTANT: Be specific with file paths and line numbers.
28YOU MUST: Explain *why* something is an issue, not just *what*.

1---
2name: investigate
3description: Investigate a bug by understanding, reproducing, and analyzing root cause
4disable-model-invocation: true
5---
6 
7Investigate: $ARGUMENTS
8 
9## Understand
101. Parse the bug description
112. Identify expected vs actual behavior
12 
13## Reproduce
141. Find reproduction steps
152. Add logging if needed to trace the issue
16 
17## Analyze
181. Search codebase for related code
192. Check git history for recent changes to affected files
203. Identify root cause
21 
22## Report
23- **Behavior:** What happens
24- **Expected:** What should happen
25- **Root Cause:** Technical explanation
26- **Files Affected:** List with line numbers
27- **Proposed Fix:** Approach and risk assessment
28 
29DO NOT fix yet — wait for approval.

1---
2name: commit
3description: Stage changes and create a well-formatted conventional commit
4disable-model-invocation: true
5---
6 
7Create a commit for the current changes:
8 
91. Run `git status` and `git diff` to understand all changes
102. Stage relevant files (not .env or credentials)
113. Write a commit message:
12   - Type: feat/fix/refactor/docs/test/chore
13   - Scope: affected area in parentheses
14   - Subject: imperative, lowercase, no period
15   - Body: explain *why*, not *what*
164. Create the commit
175. Show `git log --oneline -3` to confirm
18 
19Format: `type(scope): subject`
20Example: `fix(auth): handle expired refresh tokens`

1---
2name: standup
3description: Generate a standup summary from yesterday's git activity
4disable-model-invocation: true
5---
6 
7Generate standup summary:
8 
91. Get yesterday's commits:
10   `git log --since="yesterday" --author="$(git config user.name)" --oneline`
112. Check current branch and status
123. Look for any failing tests
13 
14## Standup — [Today's Date]
15 
16### Yesterday
17- [List from commits]
18 
19### Today
20- [Current branch/task]
21 
22### Blockers
23- [Any issues found]

1---
2name: api-endpoint
3description: Generate a new API endpoint following project conventions
4disable-model-invocation: true
5---
6 
7Create an API endpoint for: $ARGUMENTS
8 
9## Our Patterns
10- Inputs validated with Zod
11- Responses use ApiResponse<T>
12- Authentication via middleware
13- Proper error handling with status codes
14 
15## Steps
161. Create src/app/api/$0/route.ts
172. Define request/response Zod schemas
183. Add authentication check
194. Implement business logic
205. Add error handling
216. Create test file
22 
23IMPORTANT: Follow existing patterns in src/app/api/

1---
2name: pr-summary
3description: Summarize changes in a pull request
4context: fork
5agent: Explore
6allowed-tools: Bash(gh *)
7---
8 
9## Pull request context
10- PR diff: !`gh pr diff`
11- PR comments: !`gh pr view --comments`
12- Changed files: !`gh pr diff --name-only`
13 
14## Your task
15Summarize this pull request: what changed, why, and any concerns.

1---
2name: deep-research
3description: Research a topic thoroughly across the codebase
4context: fork
5agent: Explore
6---
7 
8Research $ARGUMENTS thoroughly:
9 
101. Find relevant files using Glob and Grep
112. Read and analyze the code
123. Map dependencies and relationships
134. Summarize findings with specific file references

codebase-visualizer/
├── SKILL.md
└── scripts/
    └── visualize.py

1---
2name: codebase-visualizer
3description: Generate an interactive tree visualization of the codebase
4allowed-tools: Bash(python *)
5---
6 
7Generate an interactive HTML tree view of the project structure:
8 
9```bash
10python ~/.claude/skills/codebase-visualizer/scripts/visualize.py .
11```
12 
13This creates `codebase-map.html` and opens it in your browser.

1api-generator/
2├── SKILL.md             # Overview and navigation
3├── reference.md         # Detailed API spec (loaded on demand)
4├── examples.md          # Example outputs
5└── templates/
6    └── route-template.ts  # Boilerplate template

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

1# Good — specific triggers
2description: "Fixes a GitHub issue by reading it, finding the code, and implementing a fix with tests. Use when someone mentions a bug or issue number."
3 
4# Bad — too vague
5description: "Helps with issues"

1---
2name: safe-reader
3description: Read and analyze files without making changes
4allowed-tools: Read, Grep, Glob
5---

1# Allow only specific skills
2Skill(commit)
3Skill(review-pr *)
4 
5# Deny specific skills
6Skill(deploy *)

git add .claude/skills/
git commit -m "feat: add team workflow skills"

1.claude/skills/my-skill/
2├── SKILL.md           # Required — main instructions
3├── reference.md       # Optional — detailed docs
4├── templates/         # Optional — boilerplate files
5├── examples/          # Optional — example outputs
6└── scripts/           # Optional — executable scripts

1---
2name: skill-name
3description: What this skill does and when to use it
4---
5 
6Instructions for Claude when this skill is invoked.
7 
81. First step
92. Second step
103. Third step
11 
12## Output Format
13Expected output format.
14 
15IMPORTANT: Critical rules.
16NEVER: Prohibited actions.