Skip to content

[Docs]: Update tools field examples in agent-development skill to use comma-separated format #132

@sjnims

Description

@sjnims

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:

  1. Line 116-117 (Complete Format example):

    tools: Read, Write, Grep
  2. Lines 230-232 (tools field format example):

    tools: Read, Write, Grep, Bash
  3. Lines 239-241 (Common tool sets section) - update all examples to comma-separated format

  4. Any other occurrences showing array format

Type of issue

  • Incorrect information
  • Outdated content

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.

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions