Docs / Skill for AI agents
For AI agents

Install the Karna skill

Karna ships a Claude Code skill: a small bundle that teaches an AI coding agent how to deploy, configure, and write rules for Karna. Install it into your agent and it will know how to operate the WAF without you explaining it each time.

Tell your agent to install it

If you run an agent with shell access (Claude Code, or any agent that can fetch a URL and run a command), just say:

say this to your agentprompt
Go to https://karna.sicuranext.com/skill and install the Karna
skill into my Claude Code skills directory.

The agent reads this page, finds the command below, and installs the skill for you.

One-line install

Installs as a personal skill in ~/.claude/skills/karna/, available in every Claude Code session:

shellbash
mkdir -p ~/.claude/skills
curl -fsSL https://karna.sicuranext.com/skill/karna-skill.tar.gz \
  | tar -xz -C ~/.claude/skills/

That is all. Open Claude Code and the karna skill is active — it loads itself whenever you ask to install, configure, or write rules for Karna.

Prefer to inspect first?

Download, look at what is inside, then extract:

shellbash
# 1. download
curl -fsSL -O https://karna.sicuranext.com/skill/karna-skill.tar.gz

# 2. see exactly what it contains (just Markdown — no code runs)
tar -tzf karna-skill.tar.gz

# 3. install
mkdir -p ~/.claude/skills
tar -xzf karna-skill.tar.gz -C ~/.claude/skills/

The bundle is plain Markdown: SKILL.md plus a reference/ folder (deploy, configuration, rules, recipes). Nothing executes on install.

Verify

shellbash
ls ~/.claude/skills/karna
# SKILL.md  reference/

To check it works, ask your agent something like "configure the Karna plugin to block in blocking mode" and watch it follow the skill's guidance.

For the full experience, clone the repo too

The skill is self-sufficient for operating Karna. For deep work it also tells the agent to read the authoritative source (schema.lua, ka_engine.lua) — which only resolves when you run the agent inside a checkout of the repo. If you clone Karna and run the agent there, the skill is picked up automatically as a project skill, no install needed:

shellbash
git clone https://github.com/sicuranext/karna.git
cd karna   # the karna skill is now available in this session