Install or initialize HOL Guard local runtime protection for Claude Code.

Apache-2.0Auto-check passedSecurity

Install Setup

skills CLI
$ npx skills add hashgraph-online/hol-guard --skill setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/hol-guard setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/hol-guard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/claude-code-plugin/skills/setup .claude/skills/setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup
GitHub stars
815
Token cost
~443 tokens
SKILL.md length
203 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Install or initialize HOL Guard local runtime protection for Claude Code.

  • Works in 6 steps: Check whether HOL Guard is already… → If hol-guard is missing, explain that… → After approval, install from PyPI with… → …
  • The user explicitly asks to install
  • Calls pipx
  • Repair HOL Guard

What it does

Setup is an agent skill from hashgraph-online/hol-guard. Install or initialize HOL Guard local runtime protection for Claude Code. Use when the user explicitly asks to install, enable, set up, or repair HOL Guard.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Security, covering Prompt injection and agent security. It works with Model Context Protocol. The repository describes itself as: Open-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime. The licence is Apache-2.0.

When your agent uses it

  • The user explicitly asks to install
  • Repair HOL Guard

Example prompts

  • “/setup”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Check whether HOL Guard is already available without changing the machine
  2. If hol-guard is missing, explain that installation changes the user's Python/pipx environment and ask for explicit approval before…
  3. After approval, install from PyPI with the documented command
  4. Initialize Guard interactively
  5. Verify the resulting local protection
  6. Tell the user what Guard reports as active or degraded. Do not claim protection from plugin installation alone.

What it can do on your machine

Read from SKILL.md and the folder at commit a59ab66. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pipx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pipx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup loads about 443 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 203 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~443

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/hol-guard at commit a59ab66, republished under its Apache-2.0 licence (© hashgraph-online). 203 words, ~443 tokens.

Download SKILL.mdSave it as .claude/skills/setup/SKILL.md (or your agent's skills folder).
name
setup
description
Install or initialize HOL Guard local runtime protection for Claude Code. Use when the user explicitly asks to install, enable, set up, or repair HOL Guard.
disable-model-invocation
true

Set up HOL Guard for Claude Code

HOL Guard is a separate open-source local runtime package. This plugin is the Claude Code discovery and setup companion; the actual security boundary is installed and maintained by the hol-guard CLI.

Follow this sequence exactly:

  1. Check whether HOL Guard is already available without changing the machine:

    bash
    command -v hol-guard && hol-guard --version
  2. If hol-guard is missing, explain that installation changes the user's Python/pipx environment and ask for explicit approval before installing it. Do not silently substitute another package manager.

  3. After approval, install from PyPI with the documented command:

    bash
    pipx install hol-guard

    If pipx is unavailable, stop and show the user the install requirement. Do not curl or execute an unreviewed bootstrap script as a fallback.

  4. Initialize Guard interactively:

    bash
    hol-guard init

    Do not add --yes unless the user explicitly requests unattended setup. hol-guard init owns Claude Code hook installation and avoids maintaining a second security implementation in this plugin.

  5. Verify the resulting local protection:

    bash
    hol-guard status
  6. Tell the user what Guard reports as active or degraded. Do not claim protection from plugin installation alone.

HOL Guard works locally without Guard Cloud. Cloud connection is optional and should only be offered when the user asks for synchronized history, team policy, fleet visibility, or shared approvals.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in integrations/claude-code-plugin/skills/setup of hashgraph-online/hol-guard.

Open the folder on GitHubat commit a59ab66

Compare with similar skills

Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup this skillhashgraph-online/hol-guard815—~443Automated safety check: PassApache-2.0
Forensifyalexgreensh/repo-forensics188—~2.5kAutomated safety check: NotesCustom licence
Plugin Scanneriflytek/skillhub5.2k2 repos~1.1kAutomated safety check: NotesApache-2.0
Security GuidejnMetaCode/shellward140—~644Automated safety check: WarnApache-2.0
Agent Security AuditOWASP/secure-agent-playbook187—~542Automated safety check: PassCC-BY-4.0
Safety Scanruvnet/ruflo74k—~409Automated safety check: NotesMIT

Similar skills

  • Forensify

    alexgreensh/repo-forensics

    Cross-agent self-inspection of your AI-agent stack. An agent skill from alexgreensh/repo-forensics.

    188 GitHub stars~2.5k tokensUpdated 11 days ago
    SecurityAuto-check: notes
  • Plugin Scanner

    iflytek/skillhub

    Scan AI agent skills, plugins, MCP servers, and agent tooling for prompt injection, unsafe commands, secret exposure, and supply-chain risks before installing or trusting them.

    5.2k GitHub starsUsed in 2 repos~1.1k tokens
    SecurityAuto-check: notes
  • Security Guide

    jnMetaCode/shellward

    OpenClaw 安全部署指南 / Security deployment guide — help users secure their OpenClaw installation

    140 GitHub stars~644 tokensUpdated 10 days ago
    SecurityAuto-check: warnings
  • Agent Security Audit

    OWASP/secure-agent-playbook

    Audit AI agent configurations for security risks — excessive permissions, prompt injection surfaces, data exfiltration paths, and missing guardrails.

    187 GitHub stars~542 tokensUpdated 13 days ago
    SecurityAuto-check passed
  • Safety Scan

    ruvnet/ruflo

    Scan inputs for prompt injection, unsafe content, and adversarial attacks using AIDefence.

    74k GitHub stars~409 tokensUpdated today
    SecurityAuto-check: notes
  • Hunt MCP

    Encod3d-Sec/TORCH

    MCP server attack hunting - tool poisoning, indirect prompt injection via tool output, rug-pull updates, cross-tool shadowing, over-permissioned/excessive-agency tools, lethal trifecta.

    329 GitHub stars~1.4k tokensUpdated 1 mo ago
    SecurityAuto-check passed

More from hashgraph-online/hol-guard

  • Hol Guard

    hashgraph-online/hol-guard

    Run HOL Guard scanner and guard operations via uv run hol-guard.

    815 GitHub stars~542 tokensUpdated today
    Auto-check passed
  • Status

    hashgraph-online/hol-guard

    Check HOL Guard local protection status for Claude Code without changing configuration.

    815 GitHub stars~231 tokensUpdated today
    Auto-check passed
  • Hol Guard Protection

    hashgraph-online/hol-guard

    Use HOL Guard to preview and protect AI-agent package installs, Cursor surfaces, CI, and automation workflows.

    815 GitHub stars~605 tokensUpdated today
    Auto-check passed

Categories

Questions about Setup

What does Setup do?

Install or initialize HOL Guard local runtime protection for Claude Code. Setup is an agent skill from hashgraph-online/hol-guard. Install or initialize HOL Guard local runtime protection for Claude Code.

When should I use Setup?

Setup fits situations like: the user explicitly asks to install; repair HOL Guard.

How do I install Setup in Claude Code?

Run `npx skills add hashgraph-online/hol-guard --skill setup -a claude-code`. Or copy the skill folder (integrations/claude-code-plugin/skills/setup in hashgraph-online/hol-guard) into .claude/skills/setup in your project. Claude Code loads it when a task matches its description.

How do I install Setup in Codex?

Run `npx skills add hashgraph-online/hol-guard --skill setup -a codex`. Or copy the skill folder (integrations/claude-code-plugin/skills/setup in hashgraph-online/hol-guard) into .agents/skills/setup in your project. Codex loads it when a task matches its description.

Can I use Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/hol-guard --skill setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup, .gemini/skills/setup, .github/skills/setup and .opencode/skills/setup in your project.

What does Setup need to run?

Going by SKILL.md and its folder, Setup needs the command-line tools its instructions call (pipx).

Does Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup use?

Setup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup use?

About 443 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup?

Skills that share tags, products or a category with Setup: Forensify (alexgreensh/repo-forensics, 188 stars), Plugin Scanner (iflytek/skillhub, 5.2k stars), Security Guide (jnMetaCode/shellward, 140 stars) and Agent Security Audit (OWASP/secure-agent-playbook, 187 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/hol-guard, which has 815 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/hol-guard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.