Skip to content

[Docs]: Fix second-person writing style in marketplace-structure skill #94

@sjnims

Description

@sjnims

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

  • Incorrect information
  • Missing information
  • Unclear explanation
  • Broken link
  • Typo or grammar
  • Outdated content
  • Other

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).

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions