Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-structure/SKILL.md - Skills section (around line 168)
What's unclear or missing?
The plugin-structure skill documents skills as a plugin component type but doesn't mention the allowed-tools frontmatter field that skills can use to restrict tool access.
The official Claude Code documentation (code.claude.com/docs/en/skills.md) describes this feature:
Use the allowed-tools frontmatter field to limit which tools Claude can use when a Skill is active
This is also documented in the CLAUDE.md for this repository:
Skills/Agents Optional Frontmatter
Both skills and agents support allowed-tools to restrict tool access:
allowed-tools: Read, Grep, Glob # Read-only skill
Use for read-only workflows, security-sensitive tasks, or limited-scope operations.
Since plugin-structure covers skills as a component type (how to organize them, SKILL.md format, etc.), users would benefit from knowing about this capability.
Suggested Improvement
Add a brief mention of allowed-tools in the Skills subsection of Component Organization. Suggested addition after the SKILL.md format example:
**Tool restrictions**: Skills can include `allowed-tools` in frontmatter to limit tool access:
```yaml
---
name: safe-reader
description: Read-only file access skill
allowed-tools: Read, Grep, Glob
---
Use for read-only workflows, security-sensitive tasks, or limited-scope operations.
## Type of issue
- [x] Missing information
## Additional Context
This was discovered during a comprehensive skill review against official Claude Code documentation. The feature is documented in:
- Official docs: https://code.claude.com/docs/en/skills.md
- Repository CLAUDE.md (Skills/Agents Optional Frontmatter section)
This is a minor enhancement - the skill is functional without it, but completeness would help users discover this capability when learning about plugin skills.
Which documentation needs improvement?
Skill documentation
Specific Location
plugins/plugin-dev/skills/plugin-structure/SKILL.md- Skills section (around line 168)What's unclear or missing?
The plugin-structure skill documents skills as a plugin component type but doesn't mention the
allowed-toolsfrontmatter field that skills can use to restrict tool access.The official Claude Code documentation (code.claude.com/docs/en/skills.md) describes this feature:
This is also documented in the CLAUDE.md for this repository:
Since plugin-structure covers skills as a component type (how to organize them, SKILL.md format, etc.), users would benefit from knowing about this capability.
Suggested Improvement
Add a brief mention of
allowed-toolsin the Skills subsection of Component Organization. Suggested addition after the SKILL.md format example:Use for read-only workflows, security-sensitive tasks, or limited-scope operations.