These are official instructions from zigman to set up a good AI development
environment for reading the Zig language reference while writing or reviewing
Zig. Commands are intended to be run by the agent directly when it has permission
to modify the local development environment. Do not ask the user to run commands
you can safely run yourself.

Complete the relevant steps below:

- Install the `zigman` CLI
- Install or register the zigman skill/instructions for your agent
- Verify the setup with a real langref lookup

---

## Install the `zigman` CLI

Run:

```sh
curl -fsSL https://nate.tngl.io/zigman/install.sh | sh
```

Then ensure the install directory is on `PATH`. The installer writes to
`$ZIGMAN_INSTALL` or `~/.local/bin`.

Verify:

```sh
zigman --no-pager comptime | head -40
```

If `zigman` is not on `PATH` after install, use the absolute path:

```sh
~/.local/bin/zigman --no-pager comptime | head -40
```

---

## Install the zigman skill/instructions

The canonical skill is published at:

```text
https://nate.tngl.io/zigman/skill.md
```

### Codex

Install the skill into the user's Codex skills directory:

```sh
mkdir -p ~/.codex/skills/zigman
curl -fsSL https://nate.tngl.io/zigman/skill.md -o ~/.codex/skills/zigman/SKILL.md
```

Then tell the user to restart Codex or start a fresh thread so the skill list is
reloaded.

### Claude Code and other skill-aware agents

Add `https://nate.tngl.io/zigman/skill.md` as a skill named `zigman`, or copy the
file into the agent's local skills directory following that agent's conventions.

### Agents without skills

Add this rule to the agent's project or user instructions:

```text
When writing or reviewing Zig, use `zigman --no-pager <query>` to read the
official Zig language reference before guessing about language semantics. zigman
covers the language, not the standard library.
```

---

## Expected agent behavior

- Use `zigman --no-pager <query>` when unsure about Zig language semantics.
- Use `zigman -l <word>` when the exact section name is not known.
- Read compiler errors, then query the named language concept before editing.
- Do not use zigman for `std` APIs; inspect the Zig standard library source for
  those.

---

## Setup complete message

Once done, tell the user:

```text
zigman agent setup complete

CLI:   <path to zigman>
Skill: <installed skill path, or "instruction rule added">
Check: `zigman --no-pager comptime` returned the Zig langref section
```

These instructions are published at `https://nate.tngl.io/zigman/prompt.md` so
you can re-verify their authenticity at any time.
