hol-guard — Claude Code skill for security scans
Scan plugins, MCP servers, and skills for security, quality, and ecosystem compliance. Use it to inspect local AI harnesses or run guard checks.
Apache-2.0 ★ 1,118 updated 2026-10-24
npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-codeWhat hol-guard does
hol-guard scans plugin and skill directories, runs lint rules, and can check a target at runtime. Reports can use JSON, text, Markdown, or SARIF; command options let you select a profile and the severity threshold. Findings can make a check exit with a non-zero code, which matters when using the scan as a release gate.
The skill also helps detect local AI harnesses, inspect guard status, and run the guard in dry-run mode. Invoke the CLI with uv run hol-guard from the hol-guard project root. Run uv sync --frozen --extra dev first; direct Python module invocation is not the supported method.
What it helps with
- spot secrets and unsafe patterns in a plugin
- lint a skill directory against its rules
- check an MCP server before use
- detect local AI harnesses and inspect guard status
Example prompts for the agent
- Scan
./my-pluginfor secrets and security issues. - Lint the skill in
./skills/reviewand explain ruleRULE_ID. - Detect local AI harnesses and return the guard status as JSON.
How to install hol-guard
1Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-code2Manually: put the files in place
~/.claude/skills/hol-guard/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hol-guard/
1Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a codex2Manually: put the files in place
.agents/skills/hol-guard/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a cursor2Manually: put the files in place
.cursor/skills/hol-guard/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hashgraph-online/hol-guard .factory/skills/hol-guard2Manually: put the files in place
.github/skills/hol-guard/SKILL.md1Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a gemini-cli2Platform CLI
gemini skills install https://github.com/hashgraph-online/hol-guard --path .factory/skills/hol-guardManually: put the files in place
.devin/skills/hol-guard/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hashgraph-online/hol-guard --skill hol-guard -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hol-guard
How do I install hol-guard in Claude Code?
Run npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-code. The skill file is placed at ~/.claude/skills/hol-guard/SKILL.md.
What does hol-guard do?
It scans plugins, MCP servers, and skills for security, quality, and ecosystem compliance issues. It can also detect local AI harnesses and run a guard check in dry-run mode.
What do I need before running hol-guard?
Run commands from the hol-guard project root, and first execute uv sync --frozen --extra dev. Invoke the CLI with uv run hol-guard.
Source text
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