Agent skill · writing content · aiskillstore

creating-skills

Guide for creating Claude Code skills following Anthropic's official best practices. Use when user wants to create a new skill, build a skill, write SKILL.md, or needs skill creation guidelines. Provides structure, naming conventions, description writing, and quality checklist.

Why this skill is useful

Provides structured guidelines and specific naming conventions for creating Claude Code skills that the AI wouldn't reliably generate on its own.

What it needs

About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

Creating Skills Guide for creating Claude Code skills following Anthropic's official best practices. Quick Start SKILL.md Structure Frontmatter (REQUIRED) Frontmatter (OPTIONAL - New in v2.1.0) Field Purpose Use Case ------- --------- ---------- context: fork Run skill in isolated forked context Large content processing (PDF, images) that could bloat main context agent Specify agent type for execution general-purpose, Explore, Plan etc. Description Formula Example: Trigger phrases to include: Action verbs: "create", "handle", "manage", "process" User intent: "wants to", "needs to", "asks for" Keywords users would say: "PR", "pull request", "review comments" Body Sections (ORDER MATTERS) 1. Title - # Skill Name 2. One-liner - Single sentence summary 3. Quick Start - Minimal steps (copy-paste ready) 4. Core Workflow - Numbered steps with code blocks 5. Helper Scripts (if any) - Table with purpose 6. Important Rules - Critical constraints (bold ALWAYS/NEVER) Naming Conventions Format Options Style Example When to Use ------- --------- ------------- Gerund (verb-ing) processing-pdfs Action-focused Noun phrase github-pr-creation Entity-focused Prefixed group github-pr- Related skills Rules Lowercase only Hyphens between words (no underscores) No spaces Descriptive but concise (2-4 words) Token Budget Component Limit Notes ----------- ------- ------- SKILL.md body < 500 lines Split if approaching Description < 1024 chars Quality over quantity Quick Start < 30 lines Minimal viable example If approaching 500 lines: 1. Move detailed examples to references/examples.md 2. Move troubleshooting to references/troubleshooting.md 3. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/creating-skills--dfbe85

View the source on GitHub

Browse the @skills marketplace