Creating Skills

This is the meta-skill for building Claude Code skills themselves. It walks you through the full structure: SKILL.md frontmatter fields, the three-level progressive disclosure system (metadata, instructions, bundled resources), and newer features like dynamic context injection and subagent execution with `context: fork`. The guidance is opinionated in useful ways: keep descriptions under 1024 chars with clear trigger phrases, stay under 500 lines in SKILL.md, don't create wrapper scripts for single commands, and match your specificity to how fragile the task is. If you're building custom skills or trying to understand how the skill system actually works, this is the reference.

skills.sh installs: 208
GitHub stars: 72
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add fvadicamo/dev-agent-skills --skill creating-skills --agent claude-code

Installs into .claude/skills of the current project.

Files

Creating skills

Guide for creating Claude Code skills following Anthropic's official best practices.

Quick start

# 1. Create skill directory
mkdir -p ~/.claude/skills/<skill-name>

# 2. Create SKILL.md with frontmatter
cat > ~/.claude/skills/<skill-name>/SKILL.md << 'EOF'
---
name: <skill-name>
description: <What it does>. Use when <trigger phrases>. <Key capabilities>.
---

# <Skill title>

<Instructions for the skill workflow>
EOF

# 3. Add optional resources as needed
mkdir -p ~/.claude/skills/<skill-name>/{scripts,references,assets}