docs: document how to reduce Claude Code skill read prompts#36793
Conversation
| ## Reduce permission prompts (Claude Code) | ||
|
|
||
| Claude Code prompts before reading files outside your project. Since globally | ||
| installed skills live under `~/.claude/skills/`, it may ask to approve reads |
There was a problem hiding this comment.
Wondering ... whether we should tighten this to mention materialize-documentation skill ... since:
- we actually have 2 skills currently
- it ties to the "opens a new documentation subdirectory"
There was a problem hiding this comment.
Oh ... heh heh ... I meant something like:
Claude Code prompts before reading files outside your project. Since globally
installed skills live under `~/.claude/skills/`, if you installed
`materialize-docs` skills globally, Claude Code may ask to approve reads each
time the skill opens a new documentation subdirectory.
There was a problem hiding this comment.
Good call, reworded to spell out the global-install condition!
| installed skills live under `~/.claude/skills/`, it may ask to approve reads | ||
| each time the skill opens a new documentation subdirectory. | ||
|
|
||
| To stop these prompts, grant read access to just the Materialize skill in |
There was a problem hiding this comment.
Thanks Kay! Just updated this.
| ## Reduce permission prompts (Claude Code) | ||
|
|
||
| Claude Code prompts before reading files outside your project. Since globally | ||
| installed skills live under `~/.claude/skills/`, it may ask to approve reads |
There was a problem hiding this comment.
Oh ... heh heh ... I meant something like:
Claude Code prompts before reading files outside your project. Since globally
installed skills live under `~/.claude/skills/`, if you installed
`materialize-docs` skills globally, Claude Code may ask to approve reads each
time the skill opens a new documentation subdirectory.
| } | ||
| ``` | ||
|
|
||
| This grants the narrowest access needed. If you have multiple skills installed |
There was a problem hiding this comment.
And per-Claude, the "narrowest access" isn't quite correct. and it suggested "This grants access to just that one skill's directory." instead, which does flow nicely with the next sentence of multiple skills.
There was a problem hiding this comment.
Agreed, "narrowest access" wasn't quite right. Changed this. Lat me know what you think!
2 participants
Globally installed agent skills live outside the project directory, so Claude Code prompts to approve reads each time the skill opens a new docs subdirectory. So adding a short section to the Coding Agent Skills page explaining how to scope read access via
additionalDirectories(orautomode) to stop the prompts.