permission-tuner — скилл для Claude Code: настройка разрешений
Скилл permission-tuner для Claude Code анализирует запросы на разрешение и отказы автомода, генерируя правила, которые сокращают прерывания. Включайте его, если разрешения мешают работе.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает permission-tuner
permission-tuner изучает логи отказов вашего проекта и выявляет, какие разрешения можно безопасно предоставить заранее, а какие требуют добавления в autoMode. Скилл проверяет все файлы настроек (глобальные, проектные, локальные), анализирует типы отказов (permission-rule, automode-blocked, user-rejected), и предлагает конкретные изменения: удалить ask-правила, которые вы всегда одобряете; добавить autoMode.environment для доверённых хранилищ и сервисов; добавить autoMode.allow для рутинных операций.
Внутри скилла — bash-скрипт, который собирает данные из ~/.claude/settings.json, локальных файлов и истории отказов; таблица «симптом → решение»; JSON-шаблон с примерами allow, ask и deny правил; и отчёт с оценкой, сколько промптов вы сэкономите за сессию. Скилл никогда не пишет в .claude/settings проекта — только предлагает изменения для вашего утверждения.
Какие задачи решает
- Сократить количество промптов о разрешениях, не устраивая в autoMode безопасный хаос
- Найти, какие ask-правила блокируют работу и как их переделать
- Добавить доверённые окружения (репозитории, реестры) в autoMode без ручного перебора
- Отследить ложные срабатывания хуков и правил, которые считают безопасные команды опасными
Примеры запросов агенту
- Анализируй логи отказов за последние 50 сессий и предложи правила для скилла permission-tuner
- Добавь в autoMode разрешения для npm-команд, которые я одобряю в каждом проекте
- Проверь, почему автомод просит подтверждение на
git pushв мой личный репозиторий, и исправь
Как установить permission-tuner
1Через маркетплейс плагинов
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflowКоманда ставит плагин pro-workflow целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill permission-tuner -a claude-code3Вручную: положить файлы
~/.claude/skills/permission-tuner/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/permission-tuner/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill permission-tuner -a codex2Вручную: положить файлы
.agents/skills/permission-tuner/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill permission-tuner -a cursor2Вручную: положить файлы
.cursor/skills/permission-tuner/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/permission-tuner2Вручную: положить файлы
.github/skills/permission-tuner/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill permission-tuner -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/permission-tunerВручную: положить файлы
.devin/skills/permission-tuner/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о permission-tuner
Как установить permission-tuner в Claude Code?
Запустите /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow. Или используйте команду npx skills add rohitg00/pro-workflow --skill permission-tuner -a claude-code. После этого откройте ~/.claude/skills/permission-tuner/SKILL.md.
Что делает permission-tuner?
Скилл анализирует логи отказов разрешений в ваших проектах и предлагает изменить правила так, чтобы автомод меньше прерывал работу. Он не меняет настройки сам — только показывает, что нужно добавить или удалить.
Какая разница между ask-правилом и autoMode.allow?
Ask-правило всегда вызывает промпт, даже в автомоде. autoMode.allow даёт разрешение классификатору без промпта, если остальные условия соблюдены. Скилл советует заменить ask-правила на autoMode-записи, если вы их всегда одобряете.
Исходный текст
SKILL.md · MIT
---
name: permission-tuner
description: Analyze permission prompts and auto mode denials, then generate permission rules and autoMode entries that cut prompt fatigue. Use when prompts keep interrupting, auto mode falls back to prompting, or after sessions with many denials.
user-invocable: true
---
# Permission Tuner
Reduce permission prompts by fixing their causes, not by piling up rules.
## Trigger
Use when:
- Permission prompts interrupt flow repeatedly
- Auto mode keeps blocking routine work or falls back to prompting everything
- Starting a new project and want to configure permissions
## How Prompts Happen
- Rules resolve first: deny > ask > allow. A matching ask rule prompts even in auto mode, and a PreToolUse hook returning `allow` cannot override it.
- In auto mode, anything no rule resolves goes to a classifier. After 3 blocks in a row or 20 in a session, auto mode pauses and prompts for everything until you approve one.
- Auto mode drops broad allow rules: `Bash(*)`, wildcarded interpreters like `Bash(node *)`, package-manager run commands, `Agent`, and `Monitor`.
- Hooks that exit 2 on harmless commands count as denials and push the session toward that fallback.
## Workflow
### Step 1: Gather data
Rules merge across scopes, so check every file that exists, not only the user file. `/permissions` shows the rules Claude Code actually loaded, and `claude auto-mode config` shows the effective `autoMode` (the classifier ignores `autoMode` in `.claude/settings.local.json`).
```bash
for f in ~/.claude/settings.json .claude/settings.json .claude/settings.local.json; do
[ -f "$f" ] && jq --arg f "$f" '{file: $f, mode: .permissions.defaultMode, allow: (.permissions.allow|length), ask: (.permissions.ask|length), deny: (.permissions.deny|length), autoMode: (.autoMode != null)}' "$f"
done
claude auto-mode config
ls -t ~/.claude/projects/*/*.jsonl | head -20 | xargs grep -ho '"toolDenialKind":"[^"]*"' | sort | uniq -c | sort -rn
```
`toolDenialKind` values seen in transcripts (undocumented, may change): `permission-rule` (rule or hook), `automode-blocked` (classifier), `automode-parsing-error` and `automode-unavailable` (no verdict, not tunable), `user-rejected` (you said no).
### Step 2: Pick the right fix
| Symptom | Fix |
|---------|-----|
| Prompt on something you always approve | Remove or narrow the ask rule |
| `permission-rule` on a harmless command | Fix the hook false positive or narrow the deny rule |
| Classifier blocks work in your own repos, registries, local services | Add an `autoMode.environment` entry |
| Classifier blocks one routine pattern | Add an `autoMode.allow` entry |
| Want outward actions only when you asked | Add an `autoMode.soft_deny` entry |
| Want a human check every time | Keep a short `permissions.ask` rule |
### Step 3: Generate rules
```json
{
"permissions": {
"allow": [
"Bash(git status)",
"Bash(npm test)",
"Bash(npm run lint)"
],
"ask": [
"Bash(git push --force*)",
"Bash(git push * main)",
"Bash(git push * main *)",
"Bash(git push *:main)",
"Bash(git push *:main *)",
"Bash(git push * master)",
"Bash(git push * master *)",
"Bash(git push *:master)",
"Bash(git push *:master *)",
"Bash(gh pr merge *)",
"Bash(npm publish*)"
],
"deny": [
"Bash(rm -rf *)",
"Read(**/.env)",
"Read(**/.env.*)"
]
},
"autoMode": {
"environment": [
"$defaults",
"Source control: repositories under github.com/your-org are trusted; feature-branch pushes are routine."
],
"allow": ["$defaults"],
"soft_deny": [
"$defaults",
"Merging a pull request needs the user's approval for that specific merge."
]
}
}
```
`autoMode` only takes effect in `~/.claude/settings.json`, managed settings, or `--settings`. Keep `"$defaults"` in each list. Check the result with `claude auto-mode config` and review custom rules with `claude auto-mode critique`.
## Output
```text
PERMISSION TUNER REPORT
Mode: [mode] Rules: [X] allow, [Y] ask, [Z] deny autoMode: [yes/no]
Denials: [n] permission-rule, [n] classifier, [n] no verdict, [n] you rejected
Remove (ask rules you always approve):
- Bash(...) -- approved [n]x
Add to autoMode.environment:
+ "..." -- clears [n] blocks
Add to autoMode.allow / soft_deny:
+ "..."
Fix hooks:
! [script] blocked [n] harmless commands
Keep asking:
~ force push, merge, publish, deploy
Estimated prompts saved per session: ~[N]
```
## Rules
- Prefer `autoMode` entries over new ask rules
- Destructive operations stay in deny or ask
- Always present changes for user approval before applying
- Never write `autoMode` into project settings
- Include estimated prompt savings
© Rohit Ghumare · MIT · rohitg00/pro-workflow