---

name: create-skill

description: Create a new Claude Code skill with proper directory structure and SKILL.md format.

Create Skill

Create a new Claude Code skill with proper directory structure and format.

Usage

Invoke with: /create-skill <skill-name> <description>

Example: /create-skill code-review Review code for best practices and potential issues

Instructions

When this skill is invoked:

1. Parse the skill name and description

   • Extract skill name (should be kebab-case, e.g., my-skill)
   • Extract or ask for a brief description of what the skill does

2. Create directory structure

   • Create directory at ~/.claude/skills/<skill-name>/
   • Create SKILL.md file inside the directory

3. Generate SKILL.md content

   The file must follow this exact format:

   Copy---
   name: <skill-name>
   
   description: <brief description of the skill>
   ---
   
   # <Skill Title>
   
   <Longer description of what this skill does>
   
   ## Usage
   
   Invoke with: `/<skill-name>` or `/<skill-name> <arguments>`
   
   ## Instructions
   
   When this skill is invoked:
   
   1. **First step**
      - Sub-step details
      - More details
   
   2. **Second step**
      - Sub-step details
   
   3. **Third step**
      ...
   
   ## Example Interaction (optional)
   
   Show example input/output
   
   ## Notes (optional)
   
   Additional notes or constraints
   

4. Ask user for skill details

   • What should the skill do?
   • What steps should it follow?
   • Any specific constraints or notes?

5. Write the file and confirm

   • Write the SKILL.md file
   • Show the created content to user
   • Confirm the skill is ready to use

Skill File Requirements

• Location: ~/.claude/skills/<skill-name>/SKILL.md (user-level, global)
• Location: .claude/skills/<skill-name>/SKILL.md (project-level)
• YAML Front Matter: Must include name and description fields
• Markdown Content: Clear instructions for Claude to follow

Example

CopyUser: /create-skill pr-review Review pull requests for code quality

Assistant: I'll create a new skill called "pr-review".

Creating directory: ~/.claude/skills/pr-review/
Creating file: ~/.claude/skills/pr-review/SKILL.md

Generated content:
---
name: pr-review

description: Review pull requests for code quality and best practices.
---

# PR Review Skill
...

Skill "pr-review" created successfully\!
You can now use it with: /pr-review