From e3218e28c5b9e0c0f79699b6eee766af82aa972d Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Sun, 7 Dec 2025 23:22:55 -0500 Subject: [PATCH] docs(skill-development): update validation checklist and clarify reference file purposes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add name format rules (lowercase, hyphens, max 64 chars) and description length limit (1024 chars) to validation checklist. Clarify reference file descriptions to explain when to use plugin-specific vs standalone workflow. Fixes #41 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- plugins/plugin-dev/skills/skill-development/SKILL.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/plugins/plugin-dev/skills/skill-development/SKILL.md b/plugins/plugin-dev/skills/skill-development/SKILL.md index 6cf611b..8fd5b2d 100644 --- a/plugins/plugin-dev/skills/skill-development/SKILL.md +++ b/plugins/plugin-dev/skills/skill-development/SKILL.md @@ -198,6 +198,8 @@ Before finalizing a skill: - [ ] SKILL.md file exists with valid YAML frontmatter - [ ] Frontmatter has `name` and `description` fields +- [ ] Name uses only lowercase letters, numbers, and hyphens (max 64 chars) +- [ ] Description is under 1024 characters - [ ] (Optional) `allowed-tools` field if restricting tool access - [ ] Markdown body is present and substantial - [ ] Referenced files actually exist @@ -297,8 +299,8 @@ Copy-paste ready skill templates in `examples/`: For detailed guidance, consult: -- **`references/skill-creation-workflow.md`** - Complete step-by-step skill creation process with examples, writing style guide, and common mistakes to avoid -- **`references/skill-creator-original.md`** - Full original skill-creator methodology +- **`references/skill-creation-workflow.md`** - Plugin-specific skill creation workflow (recommended for plugin skills) +- **`references/skill-creator-original.md`** - Original generic skill-creator methodology (includes init/packaging scripts for standalone skills) ### Study These Skills