Agent skill · writing content · aiskillstore

creating-skills

Creates new Claude Code skills following best practices. Guides through skill structure, naming, descriptions, and progressive disclosure. Use when user wants to create a skill, build a skill, make a new capability, or asks about skill best practices.

Why this skill is useful

Provides structured templates and validation checklists for creating Claude Code skills that the AI wouldn't reliably generate on its own.

What it needs

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

What this skill does

Creating Skills Guides creation of Claude Code skills using documented best practices. Quick Start For a new skill: 1. Ask user for skill purpose and target users 2. Generate using appropriate template 3. Validate against checklist For reviewing existing skill: 1. Read SKILL.md and supporting files 2. Check against anti-patterns in reference.md 3. Report issues with fixes Workflow: Create New Skill Step 1: Gather Requirements Ask user with AskUserQuestion: What should this skill do? (purpose) When should it activate? (trigger words) Simple or complex? (affects structure) Step 2: Choose Structure Complexity Structure When to Use ------------ ----------- ------------- Basic Single SKILL.md Simple workflows, < 200 lines Advanced SKILL.md + references Complex domains, multiple workflows Step 3: Generate Skill Use templates from templates/ directory: templates/basic.md - Single file skill templates/advanced.md - Multi-file with references Create in appropriate location: ~/.claude/skills/ - Personal skills .claude/skills/ - Project skills (git-tracked) Step 4: Validate Run through checklist before finishing: Naming Rules Format: verb-ing-noun (gerund form) processing-pdfs analyzing-spreadsheets managing-databases Constraints: Max 64 characters Lowercase letters, numbers, hyphens only No: anthropic, claude, XML tags Description Best Practices The description determines when Claude activates the skill. Include: What the skill does When to use it Trigger words users might say Format: Third person, active voice Progressive Disclosure Keep SKILL.md lean. Move details to reference files: Key rule: References should be one level deep. All reference files link directly from SKILL.md. See reference.md for detailed best practices and anti-patterns. …

How to use it

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

@skills aiskillstore/creating-skills--245e3d

View the source on GitHub

Browse the @skills marketplace