Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/mcp-integration/references/tool-usage.md:409
What's unclear or missing?
The skill reference file uses second-person ("you're") in instructional text, which violates the skill writing style guidelines.
Per the skill-development skill guidelines:
Write the entire skill using imperative/infinitive form (verb-first instructions), not second person.
Current text (line 409):
Ensure you're authenticated to Asana before running this command.
Note: The other "you" occurrences on lines 388-389 are acceptable because they appear inside an example error message displayed to users, not in instructional text.
Suggested Improvement
Option 1 (imperative):
Ensure authentication to Asana before running this command.
Option 2 (passive, slightly more natural):
Authentication to Asana is required before running this command.
Type of issue
Additional Context
This was identified during a comprehensive review of the mcp-integration skill against Claude Code plugin skill best practices. The skill is otherwise high-quality and follows all guidelines correctly.
Reference: plugins/plugin-dev/skills/skill-development/SKILL.md - Writing Style Requirements section
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/mcp-integration/references/tool-usage.md:409What's unclear or missing?
The skill reference file uses second-person ("you're") in instructional text, which violates the skill writing style guidelines.
Per the
skill-developmentskill guidelines:Current text (line 409):
Note: The other "you" occurrences on lines 388-389 are acceptable because they appear inside an example error message displayed to users, not in instructional text.
Suggested Improvement
Option 1 (imperative):
Option 2 (passive, slightly more natural):
Type of issue
Additional Context
This was identified during a comprehensive review of the
mcp-integrationskill against Claude Code plugin skill best practices. The skill is otherwise high-quality and follows all guidelines correctly.Reference:
plugins/plugin-dev/skills/skill-development/SKILL.md- Writing Style Requirements section