Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-settings/SKILL.md (line 105)
plugins/plugin-dev/skills/plugin-settings/examples/create-settings-command.md (line 3)
What's unclear or missing?
The allowed-tools frontmatter field uses incorrect JSON array syntax instead of the official comma-separated string format.
Current (incorrect):
# SKILL.md line 105
allowed-tools: ["Read", "Bash"]
# examples/create-settings-command.md line 3
allowed-tools: ["Write", "AskUserQuestion"]
Per official docs:
allowed-tools: Read, Grep, Glob
Suggested Improvement
Change from JSON array syntax to comma-separated string format:
| File |
Current |
Should Be |
SKILL.md:105 |
allowed-tools: ["Read", "Bash"] |
allowed-tools: Read, Bash |
examples/create-settings-command.md:3 |
allowed-tools: ["Write", "AskUserQuestion"] |
allowed-tools: Write, AskUserQuestion |
Type of issue
Additional Context
Per official Claude Code documentation:
Both sources show allowed-tools using comma-separated string format, not JSON arrays.
Found during comprehensive skill review against official documentation.
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-settings/SKILL.md(line 105)plugins/plugin-dev/skills/plugin-settings/examples/create-settings-command.md(line 3)What's unclear or missing?
The
allowed-toolsfrontmatter field uses incorrect JSON array syntax instead of the official comma-separated string format.Current (incorrect):
Per official docs:
Suggested Improvement
Change from JSON array syntax to comma-separated string format:
SKILL.md:105allowed-tools: ["Read", "Bash"]allowed-tools: Read, Bashexamples/create-settings-command.md:3allowed-tools: ["Write", "AskUserQuestion"]allowed-tools: Write, AskUserQuestionType of issue
Additional Context
Per official Claude Code documentation:
Both sources show
allowed-toolsusing comma-separated string format, not JSON arrays.Found during comprehensive skill review against official documentation.