Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/agent-development/SKILL.md - Multiple locations showing tools field examples
What's unclear or missing?
The agent-development skill shows tools field using array format, but the official Claude Code documentation (sub-agents.md) uses comma-separated format. This inconsistency could cause users to use the wrong format when creating agents.
Current examples in SKILL.md (array format):
tools: ["Read", "Write", "Grep", "Bash"]
tools: ["Read", "Write", "Grep"]
Official format from sub-agents.md (comma-separated):
tools: Read, Grep, Glob, Bash
Note: The actual agents in this plugin (plugin-validator.md, skill-reviewer.md, agent-creator.md) correctly use the comma-separated format. Only the documentation examples are inconsistent.
Suggested Improvement
Update all tools field examples in the agent-development skill to use comma-separated format:
Before:
tools: ["Read", "Write", "Grep", "Bash"]
After:
tools: Read, Write, Grep, Bash
Locations to update:
-
Line 116-117 (Complete Format example):
-
Lines 230-232 (tools field format example):
tools: Read, Write, Grep, Bash
-
Lines 239-241 (Common tool sets section) - update all examples to comma-separated format
-
Any other occurrences showing array format
Type of issue
Additional Context
Found during comprehensive agent review comparing against:
The official sub-agents.md documentation clearly shows:
tools: tool1, tool2, tool3 # Optional - inherits all tools if omitted
And the example agent uses:
tools: Read, Grep, Glob, Bash
This change ensures the skill documentation matches official Claude Code documentation and the actual format used by this plugin's agents.
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/agent-development/SKILL.md- Multiple locations showing tools field examplesWhat's unclear or missing?
The agent-development skill shows
toolsfield using array format, but the official Claude Code documentation (sub-agents.md) uses comma-separated format. This inconsistency could cause users to use the wrong format when creating agents.Current examples in SKILL.md (array format):
Official format from sub-agents.md (comma-separated):
Note: The actual agents in this plugin (
plugin-validator.md,skill-reviewer.md,agent-creator.md) correctly use the comma-separated format. Only the documentation examples are inconsistent.Suggested Improvement
Update all
toolsfield examples in the agent-development skill to use comma-separated format:Before:
After:
Locations to update:
Line 116-117 (Complete Format example):
Lines 230-232 (tools field format example):
Lines 239-241 (Common tool sets section) - update all examples to comma-separated format
Any other occurrences showing array format
Type of issue
Additional Context
Found during comprehensive agent review comparing against:
The official sub-agents.md documentation clearly shows:
And the example agent uses:
This change ensures the skill documentation matches official Claude Code documentation and the actual format used by this plugin's agents.