Skill Creator Skill

You have expertise in creating Claude Code skills - auto-invoked capabilities that activate based on context.

When to Use

This skill activates for:

•Creating new skills for Claude Code
•Defining skill structures and frontmatter
•Converting expertise into skill format
•Helping users build custom skills
•Organizing skill bundles

Skill Structure

Basic SKILL.md Template

markdown

---
name: skill-name
description: When Claude should auto-invoke this skill. Be specific about triggers.
---

# Skill Name

Brief description of your expertise.

## When to Use

Bullet points of scenarios that trigger this skill:
- Scenario 1
- Scenario 2
- Scenario 3

## Core Capabilities

### Capability 1
Explanation and code examples...

### Capability 2
Explanation and code examples...

## Patterns & Templates

Code templates that users commonly need...

## Best Practices

1. **Practice 1** - Explanation
2. **Practice 2** - Explanation

## Common Pitfalls

- Pitfall 1: How to avoid
- Pitfall 2: How to avoid

Frontmatter Fields

yaml

---
name: kebab-case-name           # Required: unique identifier
description: |                   # Required: triggers auto-invocation
  Detailed description of when Claude should use this skill.
  Include keywords that users might mention.
disable-model-invocation: false  # Optional: set true for manual-only
---

Skill Categories

Development Skills

code

.claude/skills/
├── api-development/      # REST API, GraphQL, webhooks
├── frontend-development/ # React, Vue, components
├── database-operations/  # SQL, ORMs, migrations
├── testing/             # Unit, E2E, integration
└── devops/              # CI/CD, Docker, deployment

Domain Skills

code

.claude/skills/
├── fintech/             # Payments, compliance, security
├── healthcare/          # HIPAA, HL7, medical systems
├── ecommerce/           # Carts, checkout, inventory
└── analytics/           # Metrics, dashboards, tracking

Tool Skills

code

.claude/skills/
├── mcp-builder/         # Creating MCP servers
├── playwright/          # Browser automation
├── prisma/              # ORM operations
└── supabase/           # BaaS integration

Writing Effective Descriptions

Good Descriptions (Specific Triggers)

yaml

description: |
  Use this skill when creating REST API endpoints, handling HTTP requests,
  implementing authentication/authorization, or adding rate limiting.
  Activates for Next.js API routes, Express handlers, and Fastify routes.

Bad Descriptions (Too Vague)

yaml

description: Helps with backend development

Keyword-Rich Descriptions

Include keywords users might say:

•Action words: "create", "build", "implement", "add"
•Technology names: "React", "Next.js", "Prisma"
•Concepts: "authentication", "pagination", "caching"

Skill Content Guidelines

1. Lead with Code

markdown

## Quick Start

\`\`\`typescript
// Immediately useful code snippet
export function example() {
  // Implementation
}
\`\`\`

2. Provide Templates

markdown

## Templates

### Basic Template
\`\`\`typescript
// Copy-paste ready code
\`\`\`

### Advanced Template
\`\`\`typescript
// More complex example
\`\`\`

3. Include Configuration

markdown

## Configuration

### package.json
\`\`\`json
{
  "dependencies": { ... }
}
\`\`\`

### Environment Variables
- `API_KEY` - Your API key
- `DATABASE_URL` - Connection string

4. Document Patterns

markdown

## Common Patterns

### Pattern 1: Name
Use when: [scenario]
\`\`\`typescript
// Implementation
\`\`\`

### Pattern 2: Name
Use when: [scenario]
\`\`\`typescript
// Implementation
\`\`\`

Creating Composite Skills

Bundle related capabilities:

code

.claude/skills/fullstack-nextjs/
├── SKILL.md              # Main skill file
├── api-patterns.md       # Additional context
├── component-library.md  # Reference material
└── deployment.md         # Deployment patterns

Main SKILL.md references others:

markdown

## Related Resources

See also:
- [API Patterns](./api-patterns.md)
- [Component Library](./component-library.md)

Testing Skills

Manual Testing

•Create skill in .claude/skills/skill-name/SKILL.md
•Start new Claude Code session
•Ask questions that should trigger the skill
•Verify skill activates and provides relevant help

Checklist

• Description triggers on expected keywords
• Code examples are copy-paste ready
• Templates compile without errors
• Best practices are actionable
• Common pitfalls are addressed

Skill Distribution

In Plugin

Add to plugin structure:

code

.claude/skills/
└── my-skill/
    └── SKILL.md

Standalone

Share skill file directly - users place in their .claude/skills/ directory.

Examples of Well-Designed Skills

Focused Skill

yaml

name: react-forms
description: |
  Use when building forms in React: form validation with react-hook-form,
  Zod schemas, error handling, form submission, and field components.

Broad Skill

yaml

name: fullstack-development
description: |
  Use for full-stack web development: Next.js pages and API routes,
  database integration, authentication, deployment, and DevOps.