[BUG] plugin-dev:agent-development skill documents wrong tools format (JSON array vs comma-separated)

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

The plugin-dev:agent-development skill teaches the wrong format for the tools field in agent frontmatter.

The skill documents:

tools: ["Read", "Write", "Grep", "Bash"]

The official Claude Code documentation says:

tools: Read, Write, Grep, Bash

Source: https://code.claude.com/docs/en/sub-agents.md

The tools field in agent frontmatter is optional and accepts a comma-separated list format

The plugin-dev skill explicitly states the opposite:

Format: Array of tool names ``yaml tools: ["Read", "Write", "Grep", "Bash"] ``

This causes agents created using the plugin-dev skill to have no access to any tools - the JSON array syntax is parsed as a literal string rather than individual tool names.

What Should Happen?

The plugin-dev:agent-development skill should document the correct comma-separated format:

# Correct
tools: Read, Grep, Glob, Bash

# Wrong (parsed as literal string, agent gets NO tools)
tools: ["Read", "Grep", "Glob", "Bash"]

Error Messages/Logs

No error - agents silently get zero tools because the format is wrong. The JSON array is parsed as a single string value rather than a list of tool names.

Steps to Reproduce

1. Run skill: plugin-dev:agent-development
2. Follow the documented format for tools
3. Create an agent with tools: ["Read", "Grep"]
4. Invoke the agent
5. Agent has access to none of the specified tools

Claude Model

Opus 4.5

Is this a regression?

I don't know

Claude Code Version

Latest

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Ghostty

Additional Information

Location of incorrect documentation:
plugins/plugin-dev/skills/agent-development/agent-development.md

Sections that need correction:

• The "tools (optional)" section under "Frontmatter Fields"
• The "Common tool sets" examples
• The "Quick Reference" section

All instances show JSON array syntax when it should be comma-separated.