edit-skill
Guide for creating and editing Agent Skills. Use this skill when you need to create or modify a skill.
When & Why to Use This Skill
This Claude skill provides a standardized framework and authoritative guide for developing, structuring, and maintaining Agent Skills. It streamlines the creation process by enforcing best practices for directory organization, metadata requirements, and modular documentation, ensuring that AI agent capabilities are scalable, maintainable, and easy to deploy.
Use Cases
- Standardizing Skill Development: Use this guide to establish a consistent directory structure and metadata format when building new capabilities for AI agents.
- Refactoring Legacy Prompts: Convert long-form agent instructions into a modular system by separating executable scripts, reference documentation, and core instructions.
- Onboarding and Compliance: Ensure all team-contributed skills meet technical requirements, such as frontmatter specifications and imperative language standards, before deployment.
| name | edit-skill |
|---|---|
| description | Guide for creating and editing Agent Skills. Use this skill when you need to create or modify a skill. |
Edit Skill
Skill Structure
skill-name/
āāā SKILL.md # instructions + metadata
āāā scripts/ # executable code (optional)
āāā references/ # documentation (optional)
āāā assets/ # templates/resources (optional)
Requirements
- Frontmatter: Must include
name(lowercase-alphanumeric) anddescription. - Description: Must include what it does and when to use it.
- Body: Keep under 500 lines. Use imperative language.
- Resources: Move detailed docs to
references/and code toscripts/.
Process
- Directory:
mkdir <name>. Createscripts/,references/, orassets/only if you actually have content for them. - Metadata: Write the
SKILL.mdfrontmatter first. - Resources: Implement scripts and test them.
- Instructions: Write concise steps in
SKILL.mdbody. - Verify: Ensure frontmatter name matches directory name.