Goal: Create well-structured Agent Skills following best practices for discoverability, conciseness, and progressive disclosure.
IMPORTANT: Skills configuration should be concise and high-level. Only include context Claude does not already know.
Workflow
- •Read references:
skills-docs.mdandbest-practices.mdin.claude/skills/skills-creator/references/ - •Analyze requirements and determine freedom level
- •Create SKILL.md using template from
.claude/skills/skills-creator/templates/template.md - •Add resources(reference files, scripts, etc.) alongside the SKILL.md file only if necessary. Use folder to organize resources.
- •Save to
.claude/skills/[skill-name]/SKILL.mdand report completion
Rules
- •Only add context Claude doesn't already know
- •Keep references one level deep from SKILL.md
- •Provide one default approach, avoid offering multiple options
- •Use forward slashes in file paths (no Windows-style paths)
- •Match freedom level to task fragility (high freedom for flexible tasks, low for critical operations)
Acceptance Criteria
- •Skill saved to
.claude/skills/[skill-name]/SKILL.md - •Name valid (max 64 chars, lowercase letters/numbers/hyphens only)
- •Description valid (max 1024 chars, third person, no "I" or "you")
- •Description includes what skill does AND when to use it
- •SKILL.md body under 500 lines
- •Consistent terminology throughout
- •No duplicate or conflicting skills exist
- •No time-sensitive information included
- •Name defined using gerund form (e.g.,
processing-pdfs,analyzing-data)