> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kyberis.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Kyberis Skill

> Install Kyberis agent skills with the published npm installer.

Use `@kyberis-ai/agent-skills` to install Kyberis investigation instructions for your agent. The skill teaches the agent how to choose Kyberis tools, handle ambiguity, interpret responses, and produce evidence-backed recommendations.

Use it together with [Kyberis MCP](/install/mcp): the skill tells the agent how to investigate, and MCP gives the agent tools to call Kyberis.

## What the Skill Provides

* Investigation workflow: resolve, evidence, relationships, assessment, hydration, final recommendation
* Trigger classification for CVEs, IOCs, actors, broad topics, and environment triage
* Endpoint selection rules
* Response decision gates for ambiguity, access errors, quotas, and weak evidence
* Output expectations for recommendations, confidence, evidence, caveats, and next actions

## Prerequisites

* [Node.js 20 or newer with `npx`](/install/node-npx)
* An agent that supports local skills or instruction bundles

## Install

Install the skill for your agent:

```bash theme={null}
npx -y @kyberis-ai/agent-skills install codex
npx -y @kyberis-ai/agent-skills install claude
npx -y @kyberis-ai/agent-skills install cursor
npx -y @kyberis-ai/agent-skills install windsurf
```

For another agent, install the generic bundle into a directory your agent can read:

```bash theme={null}
npx -y @kyberis-ai/agent-skills install generic --dir ./kyberis-agent-skill
```

## Install Locations

The installer writes the Kyberis skill into the agent's local skill directory:

| Agent    | Install location                                             |
| -------- | ------------------------------------------------------------ |
| Codex    | `~/.codex/skills/kyberis`                                    |
| Claude   | `~/.claude/skills/kyberis`                                   |
| Cursor   | `~/.cursor/skills/kyberis` and `~/.cursor/rules/kyberis.mdc` |
| Windsurf | `~/.codeium/windsurf/skills/kyberis`                         |
| Generic  | The directory passed with `--dir`                            |

Use `--dir <path>` to install to a custom directory. Generic installs require `--dir` because unsupported agents do not share a standard skill path.

## Update Installed Skills

Refresh installed Kyberis skills with:

```bash theme={null}
npx -y @kyberis-ai/agent-skills@latest update
```

`update` refreshes any installed Kyberis skill that has a Kyberis-generated manifest. If local edits are detected, the installer refuses to overwrite unless you pass `--force`.

## Check Status

```bash theme={null}
npx -y @kyberis-ai/agent-skills status codex
npx -y @kyberis-ai/agent-skills status claude
npx -y @kyberis-ai/agent-skills status cursor
npx -y @kyberis-ai/agent-skills status windsurf
npx -y @kyberis-ai/agent-skills status generic --dir ./kyberis-agent-skill
```

## Verify

Restart or reload your agent, then ask:

```text theme={null}
Use the Kyberis skill. What workflow should you follow for a CVE-first investigation?
```

The answer should start with entity resolution, focused evidence retrieval, relationship pivots, and a CVE assessment.

## Use with MCP

<Card title="Install MCP" icon="https://mintcdn.com/kyberis/c-TjxE2WqJIPZVhQ/icons/mcp.svg?fit=max&auto=format&n=c-TjxE2WqJIPZVhQ&q=85&s=7863df3c06b580b0bb617a65bf1f7b4a" href="/install/mcp" width="24" height="24" data-path="icons/mcp.svg">
  Connect a supported agent client to Kyberis tools with `@kyberis-ai/mcp`.
</Card>