Agent skill · writing content · aiskillstore
skill-creator
How to properly create Claude Code skills - teaches global vs project-local, naming conventions, and proper file structure
Why this skill is useful
Teaches specific naming conventions and file structures for 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
Skill Creator - How to Properly Create Claude Code Skills Purpose This skill teaches you how to create new Claude Code skills and where to put them. Use this EVERY TIME you need to create a new skill to avoid common mistakes. Critical Rule: Global vs Project-Local DEFAULT: GLOBAL SKILLS (~/.claude/skills/) 99% of skills belong here. This is your personal skills library that works across ALL projects. Examples of global skills: housekeeping - Repository cleanup (works on any repo) update-readme - Documentation updates (works on any repo) handbook - Amplify Gen 2 knowledge (works across projects) skills-sync - Skill management (global utility) Location: ~/.claude/skills/skill-name/SKILL.md RARE: PROJECT-LOCAL SKILLS (.claude/skills/) Only use this for skills that are specific to ONE project and make no sense elsewhere. Example of a valid project-local skill: documentation-updater - Updates docs using THIS project's specific structure Location: .claude/skills/skill-name.md When in Doubt: USE GLOBAL! If you're asking "Should this be global or local?" → It's global. --- How to Create a New Skill (Step-by-Step) Step 1: Decide the Skill Name Use lowercase-with-hyphens: ✅ housekeeping ✅ update-readme ✅ code-review ❌ Housekeeping (no capital letters) ❌ updatereadme (use hyphens, not underscores) Step 2: Create the Directory Step 3: Create the SKILL.md File Step 4: Write the Skill Content 🚨 CRITICAL: Every SKILL.md MUST start with YAML frontmatter! YAML Frontmatter Requirements: name: Must match directory name, lowercase-with-hyphens (max 64 chars) description: What the skill does AND when to use it (max 1024 chars) Include key trigger words users would mention Be specific about when Claude should activate it Example: "Extract text from PDFs, fill forms. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/skill-creator--b975c7