Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add hashgraph-online/hol-guard --skill hol-guard -a claude-code
Open on GitHub

What 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-plugin for secrets and security issues.
  • Lint the skill in ./skills/review and explain rule RULE_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-code

2Manually: put the files in place

~/.claude/skills/hol-guard/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hol-guard/

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

Similar skills

All skills for Security →

From the same set8

Project sponsors

Companies that keep this analytics open