Our review

This skill creates a new Claude Code skill by generating a structured SKILL.md file in the .claude/skills/ directory.

Strengths

Guides the user through a clear and repeatable process
Includes concrete examples and best practices
Automates directory structure and content creation

Limitations

Requires prior understanding of Claude Code skills concept
Limited to creating one skill at a time
Does not handle dependencies between skills

When to use it

Use this skill whenever you need to define a new reusable workflow for Claude Code in your project.

When not to use it

Do not use it if you need to modify an existing skill or if you are working with an agent other than Claude Code.

Examples

Create a commit message skill

Create a skill called 'commit-message' that helps write conventional commit messages with proper formatting.

Create a feature branch skill

Define a skill named 'feature-workflow' for guiding the full feature branch lifecycle from planning to deployment.

Create a quiet command skill

Create a skill that filters verbose output from bash commands to reduce context usage.

🎯 Define Skill

Create a new Claude Code skill to automate workflows and guide development patterns.

Arguments: <skill-name> [description]

📚 What Are Skills?

Skills are auto-activated workflows stored in .claude/skills/ that:

Guide Claude through repetitive development patterns
Reduce context usage with optimized commands
Ensure consistency across sessions
Activate automatically based on user intent

🏗️ Skill Structure

Each skill is a directory with a SKILL.md file:

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

📝 SKILL.md Format

---
name: Human Readable Name
description: When to activate this skill. Activate when [trigger conditions].
allowed-tools: Bash, Read, Write, Edit, Glob, Grep
---

# Skill Name

## When to Use
Activate whenever the user asks to:
- [Trigger condition 1]
- [Trigger condition 2]
- [Trigger condition 3]

## Instructions

[Step-by-step workflow with specific commands and best practices]

### Step 1: [Action]
[Details and code examples]

### Step 2: [Action]
[Details and code examples]

## Best Practices

- [Practice 1]
- [Practice 2]

## Integration with Other Skills

This skill works together with:
- **Other Skill Name**: [How they interact]

✨ Skill Creation Workflow

When user provides skill details, follow this process:

Parse Arguments
- Extract skill name (kebab-case)
- Extract description or ask for clarification
Create Directory
```
mkdir -p .claude/skills/[skill-name]
```
Generate SKILL.md
- Add YAML frontmatter with name, description, allowed-tools
- Define "When to Use" triggers
- Write step-by-step instructions
- Include code examples
- Add best practices
- Note integration with other skills
Confirm Creation
- Show skill name and location
- Display activation triggers
- Explain when Claude will use it

🎨 Skill Examples

Simple Skill (Quiet Command)

Purpose: Filter verbose output to reduce context
Pattern: Wrap command with grep filter
Tools: Bash only

Complex Skill (Feature Development)

Purpose: Guide full feature branch workflow
Pattern: Plan → Branch → Build → Deploy → Iterate
Tools: Multiple (Bash, Read, Write, Edit)

💡 Best Practices for Skills

Clear Activation Triggers: Be specific about when skill activates
Step-by-Step Instructions: Number steps, provide exact commands
Code Examples: Show concrete command syntax
Context Efficiency: Use grep patterns, quiet flags, filtered output
Integration Notes: Explain how skill works with others
Tool Restrictions: Only list tools the skill actually needs

🔧 Scope

Project Skills: .claude/skills/ (this project only)
Global Skills: Not supported (skills are project-specific)

📖 Additional Resources

Existing skills in .claude/skills/ for reference patterns
Skills activate automatically based on description triggers
No need to manually invoke skills - Claude recognizes intent

Create a Claude Code Skill

Recommended for