Skip to content

[Docs]: Fix second-person usage in mcp-integration skill reference #79

@sjnims

Description

@sjnims

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

  • Typo or grammar (writing style consistency)

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

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions