Skill Creator
Authors and structures professional-grade agent skills following the agentskills.io spec.
Install
npx skills add mgechev/skills-best-practices --skill skill-creator -g -a claude-code -y- Repository
- mgechev/skills-best-practices2.3k
- Category
- AI and agents
- Updated
- 3mo ago
- License
- See repository
- Context cost
- Lightabout 996 tokens
- Runs scripts
- Yes, review before use
What it does
Authors and structures professional-grade agent skills following the agentskills.io spec. Use when creating new skill directories, drafting procedural instructions, or optimizing metadata for discoverability. Don't use for general documentation, non-agentic library code, or README files.
Skill Authoring Procedure
Follow these steps to generate a skill that adheres to the agentskills.io specification and progressive disclosure principles.
Step 1: Initialize and Validate Metadata
- Define a unique
name: 1-64 characters, lowercase, numbers, and single hyphens only. This must exactly match the parent directory name (e.g., nameangular-testingmust live inangular-testing/SKILL.md). - Draft a
description: Max 1,024 characters, written in the third person. Include positive triggers ("Use when...") and negative triggers ("Don't use for..."). - Execute Validation Script: Run the validation script to ensure compliance before proceeding:
python3 scripts/validate-metadata.py --name "[name]" --description "[description]" - If the script returns an error, self-correct the metadata based on the
stderroutput and re-run until successful.
Step 2: Structure the Directory
- Create the root directory using the validated
name. - Initialize the following subdirectories:
scripts/: For tiny CLI tools and deterministic logic.references/: For flat (one-level deep) context like schemas or API docs.assets/: For output templates, JSON schemas, or static files.
- Ensure no human-centric files (such as
README.md,CHANGELOG.md,INSTALLATION.md) are created.
