soul-guardian — скилл для Claude Code: защита и установка
Скилл soul-guardian для Claude Code отслеживает изменения в рабочих файлах агента, восстанавливает защищённые версии и отправляет предупреждения. Контролирует целостность workspace.
AGPL-3.0 258 установок ★ 1 135 обновлён 2026-10-25
npx skills add prompt-security/clawsec --skill soul-guardian -a claude-codeЧто делает soul-guardian
soul-guardian сравнивает файлы рабочего пространства с утверждённым baseline по SHA-256. При изменении SOUL.md и AGENTS.md он может автоматически вернуть сохранённую версию и создать предупреждение. Для USER.md, TOOLS.md, IDENTITY.md, HEARTBEAT.md и MEMORY.md предусмотрен режим уведомлений, а memory/*.md игнорируется.
В комплекте есть скрипт skills/soul-guardian/scripts/soul_guardian.py. Он умеет создать baseline, проверить drift, работать в режиме наблюдения, подтверждать намеренные изменения, показывать статус и проверять целостность audit log. Для проверки создаются unified diff, локальное состояние аудита и quarantine-данные. Скилл отказывается работать с symlink и использует атомарную запись при восстановлении.
Без python3 скилл не запустится. Режим восстановления намеренно перезаписывает изменённые файлы, поэтому перед включением мониторинга проверьте baseline.
Какие задачи решает
- обнаружить изменения в файлах рабочего пространства агента
- восстановить
SOUL.mdиAGENTS.mdиз baseline - получить предупреждение о drift через heartbeat
- подтвердить намеренное изменение защищённого файла
- проверить целостность журнала аудита
Примеры запросов агенту
- Инициализируй baseline для файлов workspace командой
python3 skills/soul-guardian/scripts/soul_guardian.py init --actor setup --note "initial baseline". - Проверь drift и выведи предупреждение командой
python3 skills/soul-guardian/scripts/soul_guardian.py check --output-format alert. - Запусти постоянный мониторинг командой
python3 skills/soul-guardian/scripts/soul_guardian.py watch --interval 30.
Как установить soul-guardian
1Через Skills CLI (Vercel)
npx skills add prompt-security/clawsec --skill soul-guardian -a claude-code2Вручную: положить файлы
~/.claude/skills/soul-guardian/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/soul-guardian/
1Через Skills CLI (Vercel)
npx skills add prompt-security/clawsec --skill soul-guardian -a codex2Вручную: положить файлы
.agents/skills/soul-guardian/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add prompt-security/clawsec --skill soul-guardian -a cursor2Вручную: положить файлы
.cursor/skills/soul-guardian/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install prompt-security/clawsec skills/soul-guardian2Вручную: положить файлы
.github/skills/soul-guardian/SKILL.md1Через Skills CLI (Vercel)
npx skills add prompt-security/clawsec --skill soul-guardian -a gemini-cli2Командой платформы
gemini skills install https://github.com/prompt-security/clawsec --path skills/soul-guardianВручную: положить файлы
.devin/skills/soul-guardian/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add prompt-security/clawsec --skill soul-guardian -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о soul-guardian
Как установить soul-guardian в Claude Code?
Выполните npx skills add prompt-security/clawsec --skill soul-guardian -a claude-code. Файл скилла появится по пути ~/.claude/skills/soul-guardian/SKILL.md.
Что делает soul-guardian?
Он сравнивает рабочие файлы с baseline, сообщает о drift и восстанавливает защищённые файлы. Для каждой проверки сохраняется информация, пригодная для аудита.
Что нужно для работы soul-guardian?
Нужен python3. Для планирования через cron можно использовать openclaw, а для расписания в macOS — launchctl.