Skip to content

Commit c04afb3

Browse files
sjnimsclaude
andauthored
docs(skill-development): update validation checklist and clarify reference file purposes (#44)
## Summary - Adds name format rules (lowercase letters, numbers, hyphens, max 64 chars) to validation checklist - Adds description length limit (1024 chars) to validation checklist - Clarifies reference file descriptions to explain when to use each ## Problem Fixes #41 The skill-development SKILL.md validation checklist was missing format requirements documented in official Claude Code docs. Additionally, the two reference files were listed without explaining when to use each. ## Solution Updated the validation checklist Structure section to include: - Name format validation (lowercase letters, numbers, hyphens, max 64 chars) - Description length check (under 1024 characters) Updated reference file descriptions to clarify purpose: - `skill-creation-workflow.md` - Plugin-specific workflow (recommended for plugin skills) - `skill-creator-original.md` - Generic methodology (includes standalone skill scripts) ## Changes - `plugins/plugin-dev/skills/skill-development/SKILL.md`: Added 2 checklist items, updated 2 reference descriptions ## Testing - [x] Markdownlint passes - [x] Changes match acceptance criteria in issue --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>
1 parent 7dbb4e5 commit c04afb3

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

  • plugins/plugin-dev/skills/skill-development

plugins/plugin-dev/skills/skill-development/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -198,6 +198,8 @@ Before finalizing a skill:
198198

199199
- [ ] SKILL.md file exists with valid YAML frontmatter
200200
- [ ] Frontmatter has `name` and `description` fields
201+
- [ ] Name uses only lowercase letters, numbers, and hyphens (max 64 chars)
202+
- [ ] Description is under 1024 characters
201203
- [ ] (Optional) `allowed-tools` field if restricting tool access
202204
- [ ] Markdown body is present and substantial
203205
- [ ] Referenced files actually exist
@@ -297,8 +299,8 @@ Copy-paste ready skill templates in `examples/`:
297299

298300
For detailed guidance, consult:
299301

300-
- **`references/skill-creation-workflow.md`** - Complete step-by-step skill creation process with examples, writing style guide, and common mistakes to avoid
301-
- **`references/skill-creator-original.md`** - Full original skill-creator methodology
302+
- **`references/skill-creation-workflow.md`** - Plugin-specific skill creation workflow (recommended for plugin skills)
303+
- **`references/skill-creator-original.md`** - Original generic skill-creator methodology (includes init/packaging scripts for standalone skills)
302304

303305
### Study These Skills
304306

0 commit comments

Comments
 (0)