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

# Agent Skills

> Install Nullspace instructions for Codex and Claude Code.

Use the Nullspace skill when local coding agents should understand the
Nullspace SDK, CLI, MCP server, machine primitives, and agent templates.

The installed references include a warm-pool recipe for agents that need to
prepare a custom template pool, wait for ready capacity, create machines with
`prefer` or `require`, then drain the pool after a burst.

## Install From GitHub

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
npx skills add catamaran-research/nullspace --skill nullspace
```

Restart the coding agent if the skill does not appear immediately.

## Install From A Checkout

Codex repo-local:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
mkdir -p .agents/skills
cp -R skills/nullspace .agents/skills/nullspace
```

Codex user-local:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
mkdir -p ~/.agents/skills
cp -R skills/nullspace ~/.agents/skills/nullspace
```

Claude Code project-local:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
mkdir -p .claude/skills
cp -R skills/nullspace .claude/skills/nullspace
```

Claude Code user-local:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
mkdir -p ~/.claude/skills
cp -R skills/nullspace ~/.claude/skills/nullspace
```

## Always-On Project Context

Copy `skills/nullspace/assets/project-AGENTS.md` or
`skills/nullspace/assets/project-CLAUDE.md` into a project when Nullspace should
be persistent context, not only an invoked skill.

Keep root project instructions short. Broad orientation belongs there; workflow
details belong in the skill and its references.

## MCP

Install the SDK with CLI and MCP extras:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
python -m pip install "nullspace-sdk[cli,mcp]==1.0.0"
```

For Claude Code and Codex on a local laptop, install the project-local docs and
MCP config pack after the SDK install:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
cd /path/to/your/project
nullspace docs install --agent all
```

Use `--agent claude-code` or `--agent codex` when you only want one local agent
surface. The command writes `.nullspace/agent-docs/` and project-local agent
instructions. For Claude Code it installs `.claude/skills/nullspace`; for
Codex it installs `.agents/skills/nullspace`. It does not require an API key
and does not edit user-level config files.

If you are installing from the repository skill files manually instead of using
`nullspace docs install`, copy:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
cp skills/nullspace/assets/claude-mcp.json .mcp.json
```

For Codex manual setup, add the TOML block from
`skills/nullspace/assets/codex-config.toml` to `~/.codex/config.toml`.

Start the coding agent from a shell where these are set:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
export NULLSPACE_API_KEY=ns_live_...
export NULLSPACE_API_URL=https://api.your-nullspace-domain
```

For platform-specific setup and verification in Codex, Claude Code, Cursor, and
VS Code, see the [Local MCP](./local-mcp) guide.

## Check Local Setup

From the installed skill directory:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
scripts/nullspace_check.sh
```

For offline schema checks without hosted API validation:

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
NULLSPACE_CHECK_SKIP_DOCTOR=1 scripts/nullspace_check.sh
```

The script does not print API key values.