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:

   markdown

   ---
   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

User: /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