Agent skill · writing content · aiskillstore
creating-skills
Use when creating new skills, documenting workflows, or standardizing processes into reusable skill definitions.
Why this skill is useful
Provides a structured template and validation process for creating reusable skills, which the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Creating Skills When to Create a Skill Create a skill when: A workflow is repeated across multiple sessions Complex multi-step processes need documentation Team needs standardized approach to a task Errors occur that a documented procedure would prevent Skill Directory Structure SKILL.md Template bash command1 command2 Frontmatter Rules Required fields (only these two allowed): Field Rules ------- ------- name Lowercase, hyphenated, gerund form (e.g., creating-skills) description Under 1024 chars, 3rd-person voice, no "you" Not allowed: Any other fields (version, author, tags, etc.) Naming Conventions Rule Good Bad ------ ------ ----- Lowercase reviewing-code Reviewing-Code Hyphens, not underscores creating-skills creatingskills Gerund form (-ing) implementing-with-tdd implement-tdd Match directory name name: foo in foo/ name: bar in foo/ Gerund Suggestions Instead of Use ------------ ----- code-review reviewing-code plan planning implement implementing design designing finish finishing Description Guidelines Good (3rd person): Manages task lifecycle transitions and coordinates Trello sync. Bad (2nd person): Use when you need to manage task lifecycle. File Size Limits SKILL.md: Under 500 lines Description: Under 1024 characters Validation Checklist Before finalizing a skill: [ ] Frontmatter has only name and description [ ] Name is lowercase-hyphenated gerund [ ] Name matches directory name [ ] Description under 1024 characters [ ] Description uses 3rd-person voice [ ] SKILL.md under 500 lines [ ] No "Claude already knows this" content [ ] Includes actionable steps or commands CLI Commands Common Validation Errors Error Fix ------- ----- Extra frontmatter fields Remove all fields except name/description Name mismatch Make frontmatter name match directory name Description too long Shorten to under 1024 characters File too long Split into SKILL.md + reference docs Creating a New Skill 1. Create directory: mkdir -p .claude/skills/{skill-name} 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/creating-skills--8ff541