From 26a1154fe0a4b246e19bb721e2352dc6c6409955 Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Wed, 10 Dec 2025 04:03:02 -0500 Subject: [PATCH 1/2] docs: add allowed-tools frontmatter documentation to plugin-structure skill MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Document the allowed-tools frontmatter field in the Skills section of the plugin-structure skill. This capability allows skills to restrict tool access for read-only workflows, security-sensitive tasks, or limited-scope operations. Fixes #91 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- plugins/plugin-dev/skills/plugin-structure/SKILL.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/plugins/plugin-dev/skills/plugin-structure/SKILL.md b/plugins/plugin-dev/skills/plugin-structure/SKILL.md index 495caf4..ffc28c2 100644 --- a/plugins/plugin-dev/skills/plugin-structure/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-structure/SKILL.md @@ -200,6 +200,18 @@ description: When to use this skill Skill instructions and guidance... ``` +**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. + **Supporting files**: Skills can include scripts, references, examples, or assets in subdirectories **Usage**: Claude Code autonomously activates skills based on task context matching the description From 5ac0f77dc3e836fd542c9de6704f885de261ff6e Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Wed, 10 Dec 2025 04:06:25 -0500 Subject: [PATCH 2/2] docs: clarify allowed-tools is optional frontmatter MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add "(optional)" label and inline comment to make clear that allowed-tools is not a required field for skills. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- plugins/plugin-dev/skills/plugin-structure/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugins/plugin-dev/skills/plugin-structure/SKILL.md b/plugins/plugin-dev/skills/plugin-structure/SKILL.md index ffc28c2..7895888 100644 --- a/plugins/plugin-dev/skills/plugin-structure/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-structure/SKILL.md @@ -200,13 +200,13 @@ description: When to use this skill Skill instructions and guidance... ``` -**Tool restrictions**: Skills can include `allowed-tools` in frontmatter to limit tool access: +**Tool restrictions** (optional): 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 +allowed-tools: Read, Grep, Glob # Optional: restricts available tools --- ```