Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/marketplace-structure/references/distribution-patterns.md:299
What's unclear or missing?
The skill-development best practices require imperative/infinitive form, not second person ("you"). Line 299 contains a second-person violation:
Current text:
For GitHub sources, ensure repository is public or you have access
This violates the writing style guidelines from the skill-development skill:
"Write using verb-first instructions, not second person"
"Use objective, instructional language (e.g., 'To accomplish X, do Y' rather than 'You should do X')"
Suggested Improvement
Change line 299 from:
3. For GitHub sources, ensure repository is public or you have access
To:
3. For GitHub sources, ensure repository is public or access is available
Type of issue
Additional Context
Found during comprehensive skill review against skill-development best practices and official Claude Code documentation. This is the only second-person violation in the entire marketplace-structure skill (SKILL.md is fully compliant).
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/marketplace-structure/references/distribution-patterns.md:299What's unclear or missing?
The skill-development best practices require imperative/infinitive form, not second person ("you"). Line 299 contains a second-person violation:
Current text:
This violates the writing style guidelines from the skill-development skill:
Suggested Improvement
Change line 299 from:
To:
Type of issue
Additional Context
Found during comprehensive skill review against skill-development best practices and official Claude Code documentation. This is the only second-person violation in the entire marketplace-structure skill (SKILL.md is fully compliant).