[Docs]: Incorrect references in skill-reviewer agent

[sjnims]

Which documentation needs improvement?

Agent documentation

Specific Location

plugins/plugin-dev/agents/skill-reviewer.md - Lines 44 and 57

What's unclear or missing?

The skill-reviewer agent contains two inaccurate references:

Issue 1: Reference to non-existent "skill-creator" (Line 44)

Current text:

"Check adherence to skill-creator best practices"

Problem: There is no skill-creator agent in this plugin. The plugin has:

• agent-creator (for creating agents)
• skill-reviewer (for reviewing skills)
• plugin-validator (for validating plugins)

Issue 2: Undocumented when_to_use deprecation claim (Line 57)

Current text:

"Optional fields: version, when_to_use (note: deprecated, use description only)"

Problem: The when_to_use field and its deprecation status are not mentioned in the official Claude Code documentation:

• https://code.claude.com/docs/en/sub-agents.md
• https://code.claude.com/docs/en/plugins-reference.md

This claim cannot be verified against official docs and may confuse users or become outdated.

Suggested Improvement

Fix 1: Update line 44

Change:

4. Check adherence to skill-creator best practices

To:

4. Check adherence to skill development best practices

Or:

4. Check adherence to best practices from the skill-development skill

Fix 2: Update line 57

Either:

• Option A: Remove the deprecation note if when_to_use was never an official field
• Option B: Add a source citation if the deprecation is documented elsewhere
• Option C: Simplify to just list the optional fields without deprecation commentary

Suggested:

- Optional fields: `version` (others may exist per Claude Code updates)

Type of issue

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

Additional Context

These issues were discovered during a comprehensive review of all 3 plugin subagents against official Claude Code plugin documentation.

🤖 Generated with Claude Code

[sjnims]

PR submitted: #115