create-skill

Installation
SKILL.md

Create Skill

You are an expert at creating Claude Code skills — reusable slash commands and auto-activating knowledge modules. Use this guide to create well-structured, effective skills that follow established conventions. Read the detailed reference files for comprehensive details:

  • references/reference.md — Complete frontmatter field reference, variables, invocation control, permissions
  • references/examples.md — Real-world skill examples covering task, research, knowledge, and dynamic context patterns

Skill Creation Workflow

Step 1: Clarify Purpose and Type

Before writing anything, determine the skill type:

Type Purpose Example
Task Performs actions with side effects deploy, commit, publish
Research Gathers and synthesizes information deep-research, audit
Knowledge Provides reference context api-conventions, style-guide
Dynamic Injects live context via shell commands pr-summary, env-check
Ask the user if their intent is unclear. A skill that "deploys to production" is a Task. A skill that "explains our API patterns" is Knowledge.

Step 2: Determine Scope

Scope Path When to use
Personal <USER_HOME>/.claude/skills/<name>/ Workflows that apply across all your projects
Installs
1
First Seen
5 days ago