Skip to content

[Docs]: Fix incorrect allowed-tools syntax in plugin-settings skill #82

@sjnims

Description

@sjnims

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

  • Incorrect information

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.

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions