skill-audit
Входящий гейт: чужой код ко мне. Любой сторонний скилл или плагин, скачанный
с GitHub, попадает в авто-загружаемый каталог ~/.claude/ без единой проверки —
а его SKILL.md уходит в контекст модели, его хуки выполняются на каждом вызове
инструмента, его .mcp.json может поднять чужой сервер с твоими правами. Этот скан —
барьер перед тем, как чужой код станет частью твоего окружения.
Граница с leak-scan
Две противоположные стороны одной двери, их легко перепутать:
|
Направление |
Вопрос |
Навык |
| Сюда |
чужое ко мне |
«безопасно ли ставить этот скачанный скилл?» |
skill-audit (этот) |
| Отсюда |
моё наружу |
«не утечёт ли что-то личное, если я это опубликую?» |
leak-scan |
Публикуешь свой пак — это leak-scan. Ставишь чужой пак — это сюда. Проверки
независимы: скилл может быть безупречно обезличен и при этом нести инъекцию, и наоборот.
Где лежит скрипт
python ~/.claude/skills/leak-scan/scripts/skill_injection_scan.py <цель> [опции]
Скрипт физически живёт в skills/leak-scan/scripts/ — там же, где его выходной
близнец leak_scan.py. Оба сканера написаны одним заходом и делят внутренности,
поэтому этот навык — инструкция к соседнему скрипту, а не отдельная программа.
Зови полным путём выше, не относительным от каталога этого навыка.
Нет каталога leak-scan — навык не работает: везти их надо парой.
Когда запускать
- Скачал скилл/плагин/агента с GitHub и до копирования в
~/.claude/skills|plugins|agents.
- Оцениваешь чужой репозиторий, из которого хочешь забрать код себе.
- Ревизия уже установленного стороннего пакета («а что оно вообще делает при загрузке?»).
Использование
<цель> — каталог скилла (со SKILL.md), каталог плагина (с plugin.json), каталог
агентов/команд, сборник (skills/+agents/+hooks/), или одиночный .md.
Тип определяется автоматически.
--min-severity CRITICAL|WARN|INFO — порог печати (по умолчанию INFO).
--allow RULE_ID — заглушить правило (повторяемо), напр. --allow hooks.registered
для заведомо доверенного пакета с хуком.
--include-vendor — сканировать и node_modules/dist/build (по умолчанию помечаются
как не проверенные, а не молча пропускаются).
--json — машинный вывод. --list-rules — список всех правил.
Коды выхода: 0 чисто · 1 есть находки (CRITICAL/WARN) · 2 скан не завершён
достоверно (симлинк-цель, превышен лимит).
# Гейт перед установкой (пайп теряет код возврата — смотри печатное CRITICAL/ЧИСТО)
python ~/.claude/skills/leak-scan/scripts/skill_injection_scan.py ./downloaded-skill
Скрипт — чистый stdlib Python, UTF-8 stdout (Windows-совместимо), ничего не меняет на диске.
Ключей и оплаты не требует: всё считается локально, сеть не используется.
Что ловит (35 правил, severity CRITICAL/WARN/INFO)
| Группа |
Правила |
Сигнал |
| Невидимый Unicode |
unicode.invisible |
ZWSP/ZWNJ/ZWJ/word-joiner/BOM, bidi-override (trojan source), теговый блок U+E0000–E007F. Emoji-ZWJ (👨💻) не флагуется |
| Prompt-injection |
prompt.ignore_previous (RU+EN), disregard_system, role_reassignment, fake_system_prefix, system_tag, chat_template_tag (<|im_start|>, [INST]), tool_call_tag, covert_directive, autonomy_grab, memory_write |
фразы-перехваты, поддельные system:/<system>, разделители чат-шаблонов, приказ действовать скрытно/дописать себя в CLAUDE.md |
| Скрытое в Markdown |
md.hidden_directive, md.hidden_style |
инструкция в HTML-комментарии или под display:none/белым шрифтом |
| Фронтматтер-захват |
frontmatter.allowed_tools, model_invocation_enabled, permission_mode |
скилл сам себе выдаёт Bash(*)/*, включает автовызов, понижает режим разрешений |
| Эксфильтрация |
tool.exfiltration_shape, net.suspicious_sink, code.credential_exfil_chain, content.base64_blob |
секрет по сети на литеральный посторонний хост; webhook.site/ngrok/paste-сервисы; чтение кред + отправка в одном файле; длинный base64-блоб |
| Опасный код |
code.remote_exec, dynamic_eval, detached_spawn, destructive, claude_config_write |
curl|sh, исполнение декодированного base64, фоновый отвязанный процесс, rm -rf ~, запись в твой конфиг Claude Code |
| Конфиг |
config.permission_widening |
пакет расширяет permissions в settings.json — тихо добавляет себе разрешения |
| Хуки (нет у источника) |
hooks.registered, hooks.dangerous_command |
плагин регистрирует хук, что выполнится на каждом вызове инструмента (matcher *) |
| MCP (нет у источника) |
mcp.server_declared, mcp.arbitrary_command, mcp.remote_server |
.mcp.json поднимает сервер с произвольной командой (bash -c …) или удалённый хост, куда уходит сессия |
| npm lifecycle (нет у источника) |
npm.lifecycle_script, npm.obfuscated_lifecycle |
postinstall/preinstall, исполняющий код при npm install; вскрывает и локальный скрипт, который тот вызывает (реальный кейс: postinstall маскировал spawn) |
| Файловая система |
fs.symlink, fs.binary_artifact |
симлинк (содержимое не проверено, может указывать наружу); исполняемый бинарник без исходников |
Точный список идентификаторов — всегда --list-rules, а не эта таблица: она пересказ.
Как читать результат
- CRITICAL — не устанавливать, пока не понятно, зачем это в пакете.
- WARN — бывает легитимно (хук, MCP-сервер, объявленный
allowed-tools), но должно
быть заявлено в README пакета; сверь, что ожидаемо.
- Правила ловят форму, а не смысл: текст про безопасность/LLM может совпасть (напр.
статья, объясняющая инъекции). Всегда смотри строку в контексте —
> excerpt
печатается рядом.
- Этот навык ловит сам себя. Таблица правил выше цитирует
<|im_start|>, system:
и webhook/paste-хосты, поэтому скан каталога скиллов даёт на skill-audit/SKILL.md
находки уровня CRITICAL (prompt.chat_template_tag, prompt.system_tag,
net.suspicious_sink). Это тот самый случай «форма, а не смысл» — не находка.
Полезный побочный эффект: так проверяется, что сканер вообще работает.
- ЧИСТО — не гарантия: прочитай
SKILL.md и скрипты глазами. Скан — первый барьер,
не последний.
Расширение правил
Правила инлайн в ~/.claude/skills/leak-scan/scripts/skill_injection_scan.py:
текстовые — _TEXT_RULES, кодовые — _CODE_RULES, структурные (JSON) — функции
_scan_hooks / _scan_mcp / _scan_package_json / _scan_json_file.
Полный список id — --list-rules. Для разового доверия — --allow RULE_ID,
не редактируй файл.
Происхождение
Идея и часть правил — из virgiliojr94/book-to-skill (tools/scan_generated_skill.py),
адаптировано и расширено проверками hooks / MCP / npm-lifecycle, которых у источника нет.
1---2name: skill-audit3description: "Проверка ЧУЖОГО скилла/плагина до установки: prompt-injection, хуки, MCP, npm (35 правил). Триггеры: «безопасно ли ставить», «скачал с гитхаба скилл». Своё наружу→leak-scan."4metadata:5 source: https://skillmd.com/skills/jhamidun/skill-audit6 version: 1.0.07 updated: 2026-08-208---910# skill-audit1112Входящий гейт: **чужой код ко мне**. Любой сторонний скилл или плагин, скачанный13с GitHub, попадает в авто-загружаемый каталог `~/.claude/` **без единой проверки** —14а его SKILL.md уходит в контекст модели, его хуки выполняются на каждом вызове15инструмента, его `.mcp.json` может поднять чужой сервер с твоими правами. Этот скан —16барьер перед тем, как чужой код станет частью твоего окружения.1718## Граница с leak-scan1920Две противоположные стороны одной двери, их легко перепутать:2122| | Направление | Вопрос | Навык |23|---|---|---|---|24| **Сюда** | чужое ко мне | «безопасно ли ставить этот скачанный скилл?» | **skill-audit** (этот) |25| **Отсюда** | моё наружу | «не утечёт ли что-то личное, если я это опубликую?» | `leak-scan` |2627Публикуешь свой пак — это `leak-scan`. Ставишь чужой пак — это сюда. Проверки28независимы: скилл может быть безупречно обезличен и при этом нести инъекцию, и наоборот.2930## Где лежит скрипт3132```bash33python ~/.claude/skills/leak-scan/scripts/skill_injection_scan.py <цель> [опции]34```3536Скрипт физически живёт в `skills/leak-scan/scripts/` — там же, где его выходной37близнец `leak_scan.py`. Оба сканера написаны одним заходом и делят внутренности,38поэтому этот навык — инструкция к соседнему скрипту, а не отдельная программа.39Зови **полным путём выше**, не относительным от каталога этого навыка.40Нет каталога `leak-scan` — навык не работает: везти их надо парой.4142## Когда запускать4344- Скачал скилл/плагин/агента с GitHub и **до** копирования в `~/.claude/skills|plugins|agents`.45- Оцениваешь чужой репозиторий, из которого хочешь забрать код себе.46- Ревизия уже установленного стороннего пакета («а что оно вообще делает при загрузке?»).4748## Использование4950- `<цель>` — каталог скилла (со `SKILL.md`), каталог плагина (с `plugin.json`), каталог51 агентов/команд, сборник (`skills/`+`agents/`+`hooks/`), **или** одиночный `.md`.52 Тип определяется автоматически.53- `--min-severity CRITICAL|WARN|INFO` — порог печати (по умолчанию INFO).54- `--allow RULE_ID` — заглушить правило (повторяемо), напр. `--allow hooks.registered`55 для заведомо доверенного пакета с хуком.56- `--include-vendor` — сканировать и `node_modules/dist/build` (по умолчанию помечаются57 как **не проверенные**, а не молча пропускаются).58- `--json` — машинный вывод. `--list-rules` — список всех правил.5960**Коды выхода:** `0` чисто · `1` есть находки (CRITICAL/WARN) · `2` скан не завершён61достоверно (симлинк-цель, превышен лимит).6263```bash64# Гейт перед установкой (пайп теряет код возврата — смотри печатное CRITICAL/ЧИСТО)65python ~/.claude/skills/leak-scan/scripts/skill_injection_scan.py ./downloaded-skill66```6768Скрипт — чистый stdlib Python, UTF-8 stdout (Windows-совместимо), **ничего не меняет на диске**.69Ключей и оплаты не требует: всё считается локально, сеть не используется.7071## Что ловит (35 правил, severity CRITICAL/WARN/INFO)7273| Группа | Правила | Сигнал |74|--------|---------|--------|75| Невидимый Unicode | `unicode.invisible` | ZWSP/ZWNJ/ZWJ/word-joiner/BOM, bidi-override (trojan source), теговый блок U+E0000–E007F. Emoji-ZWJ (👨💻) не флагуется |76| Prompt-injection | `prompt.ignore_previous` (RU+EN), `disregard_system`, `role_reassignment`, `fake_system_prefix`, `system_tag`, `chat_template_tag` (`<\|im_start\|>`, `[INST]`), `tool_call_tag`, `covert_directive`, `autonomy_grab`, `memory_write` | фразы-перехваты, поддельные `system:`/`<system>`, разделители чат-шаблонов, приказ действовать скрытно/дописать себя в CLAUDE.md |77| Скрытое в Markdown | `md.hidden_directive`, `md.hidden_style` | инструкция в HTML-комментарии или под `display:none`/белым шрифтом |78| Фронтматтер-захват | `frontmatter.allowed_tools`, `model_invocation_enabled`, `permission_mode` | скилл сам себе выдаёт `Bash(*)`/`*`, включает автовызов, понижает режим разрешений |79| Эксфильтрация | `tool.exfiltration_shape`, `net.suspicious_sink`, `code.credential_exfil_chain`, `content.base64_blob` | секрет по сети на литеральный посторонний хост; webhook.site/ngrok/paste-сервисы; чтение кред + отправка в одном файле; длинный base64-блоб |80| Опасный код | `code.remote_exec`, `dynamic_eval`, `detached_spawn`, `destructive`, `claude_config_write` | `curl\|sh`, исполнение декодированного base64, фоновый отвязанный процесс, `rm -rf ~`, запись в твой конфиг Claude Code |81| Конфиг | `config.permission_widening` | пакет расширяет `permissions` в settings.json — тихо добавляет себе разрешения |82| **Хуки** (нет у источника) | `hooks.registered`, `hooks.dangerous_command` | плагин регистрирует хук, что выполнится **на каждом** вызове инструмента (matcher `*`) |83| **MCP** (нет у источника) | `mcp.server_declared`, `mcp.arbitrary_command`, `mcp.remote_server` | `.mcp.json` поднимает сервер с произвольной командой (`bash -c …`) или удалённый хост, куда уходит сессия |84| **npm lifecycle** (нет у источника) | `npm.lifecycle_script`, `npm.obfuscated_lifecycle` | `postinstall/preinstall`, исполняющий код при `npm install`; вскрывает и локальный скрипт, который тот вызывает (реальный кейс: postinstall маскировал `spawn`) |85| Файловая система | `fs.symlink`, `fs.binary_artifact` | симлинк (содержимое не проверено, может указывать наружу); исполняемый бинарник без исходников |8687Точный список идентификаторов — всегда `--list-rules`, а не эта таблица: она пересказ.8889## Как читать результат9091- **CRITICAL** — не устанавливать, пока не понятно, зачем это в пакете.92- **WARN** — бывает легитимно (хук, MCP-сервер, объявленный `allowed-tools`), но должно93 быть заявлено в README пакета; сверь, что ожидаемо.94- Правила ловят **форму, а не смысл**: текст про безопасность/LLM может совпасть (напр.95 статья, объясняющая инъекции). Всегда смотри строку в контексте — `> excerpt`96 печатается рядом.97- **Этот навык ловит сам себя.** Таблица правил выше цитирует `<|im_start|>`, `system:`98 и webhook/paste-хосты, поэтому скан каталога скиллов даёт на `skill-audit/SKILL.md`99 находки уровня CRITICAL (`prompt.chat_template_tag`, `prompt.system_tag`,100 `net.suspicious_sink`). Это тот самый случай «форма, а не смысл» — не находка.101 Полезный побочный эффект: так проверяется, что сканер вообще работает.102- ЧИСТО — не гарантия: прочитай `SKILL.md` и скрипты глазами. Скан — первый барьер,103 не последний.104105## Расширение правил106107Правила инлайн в `~/.claude/skills/leak-scan/scripts/skill_injection_scan.py`:108текстовые — `_TEXT_RULES`, кодовые — `_CODE_RULES`, структурные (JSON) — функции109`_scan_hooks` / `_scan_mcp` / `_scan_package_json` / `_scan_json_file`.110Полный список id — `--list-rules`. Для разового доверия — `--allow RULE_ID`,111не редактируй файл.112113## Происхождение114115Идея и часть правил — из `virgiliojr94/book-to-skill` (`tools/scan_generated_skill.py`),116адаптировано и расширено проверками hooks / MCP / npm-lifecycle, которых у источника нет.