Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-structure/README.md
What's unclear or missing?
The plugin-structure skill contains a README.md file that is not part of the official Claude Code skill structure.
Per the official docs (https://code.claude.com/docs/en/skills.md) and the skill-development skill, a skill directory should contain:
SKILL.md (required)
references/ (optional)
examples/ (optional)
scripts/ (optional)
assets/ (optional)
README.md is not a recognized skill component and introduces:
- Maintenance burden - Contains word counts (e.g., "SKILL.md (1,654 words)") that can drift from actual values
- Redundancy - Duplicates information already in SKILL.md header and body
- Non-conformance - Violates the skill specification
Suggested Improvement
Remove the README.md file entirely. The skill's structure, purpose, and trigger conditions are already documented in SKILL.md's frontmatter and body.
rm plugins/plugin-dev/skills/plugin-structure/README.md
Type of issue
Additional Context
Found during comprehensive skill review against official Claude Code documentation (skills.md and plugins-reference.md).
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-structure/README.mdWhat's unclear or missing?
The
plugin-structureskill contains aREADME.mdfile that is not part of the official Claude Code skill structure.Per the official docs (https://code.claude.com/docs/en/skills.md) and the
skill-developmentskill, a skill directory should contain:SKILL.md(required)references/(optional)examples/(optional)scripts/(optional)assets/(optional)README.mdis not a recognized skill component and introduces:Suggested Improvement
Remove the
README.mdfile entirely. The skill's structure, purpose, and trigger conditions are already documented in SKILL.md's frontmatter and body.Type of issue
Additional Context
Found during comprehensive skill review against official Claude Code documentation (skills.md and plugins-reference.md).