hol-guard — скилл для Claude Code: проверка безопасности
Скилл hol-guard сканирует плагины, MCP-серверы и скиллы на проблемы безопасности, качества и соответствия требованиям экосистемы. Также помогает проверять и запускать защитные операции для локальных AI-сред.
Apache-2.0 ★ 1 118 обновлён 2026-10-24
npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-codeЧто делает hol-guard
hol-guard запускает сканирование каталогов плагинов и скиллов, проверяет правила линтером и может проверять работу цели во время выполнения. Для отчётов доступны форматы JSON, text, Markdown и SARIF; профили и порог серьёзности находок задаются параметрами команды. Результат важен для решения о публикации: находки могут завершить проверку ненулевым кодом.
Скилл также помогает обнаруживать локальные AI-среды, проверять статус защиты и запускать её в режиме пробного выполнения. Команды вызываются через uv run hol-guard, из корня проекта hol-guard. Перед запуском нужно выполнить uv sync --frozen --extra dev; запускать модули Python напрямую нельзя.
Какие задачи решает
- найти секреты и небезопасные шаблоны в плагине
- проверить скилл по правилам качества и безопасности
- проверить MCP-сервер перед использованием
- обнаружить локальную AI-среду и узнать статус защиты
Примеры запросов агенту
- Просканируй каталог
./my-pluginна секреты и проблемы безопасности. - Проверь правила для скилла в
./skills/reviewи объясни правилоRULE_ID. - Обнаружь локальные AI-среды и покажи статус защиты в формате JSON.
Как установить hol-guard
1Через Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-code2Вручную: положить файлы
~/.claude/skills/hol-guard/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hol-guard/
1Через Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a codex2Вручную: положить файлы
.agents/skills/hol-guard/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a cursor2Вручную: положить файлы
.cursor/skills/hol-guard/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hashgraph-online/hol-guard .factory/skills/hol-guard2Вручную: положить файлы
.github/skills/hol-guard/SKILL.md1Через Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a gemini-cli2Командой платформы
gemini skills install https://github.com/hashgraph-online/hol-guard --path .factory/skills/hol-guardВручную: положить файлы
.devin/skills/hol-guard/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hol-guard
Как установить hol-guard в Claude Code?
Выполните npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/hol-guard/SKILL.md.
Что делает hol-guard?
Сканирует плагины, MCP-серверы и скиллы на проблемы безопасности, качества и соответствия требованиям экосистемы. Также умеет обнаруживать локальные AI-среды и запускать проверку защиты в режиме пробного выполнения.
Что нужно перед запуском hol-guard?
Запускайте команды из корня проекта hol-guard и сначала выполните uv sync --frozen --extra dev. CLI вызывается через uv run hol-guard.
Исходный текст
SKILL.md · Apache-2.0
--- name: hol-guard description: Run HOL Guard scanner and guard operations via `uv run hol-guard`. Use when the user asks to scan plugins/MCP/skills for security, quality, or ecosystem compliance, or when they ask to run guard detect/install/protect workflows for local AI harnesses. --- # HOL Guard HOL Guard is an AI Antivirus scanner that checks plugins, MCP servers, skills, and local AI harnesses for security, quality, and ecosystem compliance. ## Prerequisites - Always run from the `hol-guard` project root. - Use `uv run hol-guard` to invoke the CLI. Never invoke Python modules directly. - Ensure `uv sync --frozen --extra dev` has been run before invoking. ## Scanner Operations Scan a plugin or skill directory: ``` uv run hol-guard scan <directory> [--format json|text|markdown|sarif] [--profile default|public-marketplace|strict-security] [--fail-on-severity critical|high|medium|low|info|none] ``` Lint rules: ``` uv run hol-guard lint <directory> [--list-rules] [--explain <rule-id>] ``` Verify runtime: ``` uv run hol-guard verify <directory> [--online] ``` List ecosystems: ``` uv run hol-guard --list-ecosystems ``` ## Guard Operations Detect harnesses: ``` uv run hol-guard detect [codex|claude|cursor|gemini|opencode] [--json] ``` Run guard in dry-run mode: ``` uv run hol-guard run <harness> --dry-run --default-action allow --json ``` Check guard status: ``` uv run hol-guard status [--json] ``` ## Common Test Fixtures Test fixtures live in `tests/fixtures/`: - `good-plugin/` - clean Codex plugin with all required fields - `bad-plugin/` - plugin with secrets, missing fields, bad practices - `malicious-skill-plugin/` - skill with malicious patterns - `multi-ecosystem-repo/` - repo with Codex, Claude, and Gemini configs - `claude-plugin-good/` - clean Claude plugin - `opencode-good/` - clean OpenCode plugin - `gemini-extension-good/` - clean Gemini extension ## Verification After each operation, verify: - Exit code 0 for clean targets - Exit code non-zero for targets with findings - Output is valid JSON when `--format json` or `--json` is used - Scanner reports findings with correct rule IDs and severities
© hashgraph-online · Apache-2.0 · hashgraph-online/hol-guard