Skip to content
nagi

Agent skill file

Preview docs describe unreleased preview builds. Stable docs remain at /docs/.

Nagi ships a reusable agent skill file at SKILL.md.

Install that file into any coding agent that supports reusable skills or custom instructions. The skill teaches the agent how to control Nagi from inside a Nagi pane.

Nagi also serves a separate guide at Nagi agent guide for a different job: an agent helping a human learn, set up, or troubleshoot Nagi. The skill is for an agent operating Nagi; the guide is for an agent teaching a human.

What the skill does

Section titled “What the skill does”

The skill tells an agent to use the nagi CLI when NAGI_ENV=1 is set. That means the agent is running inside a Nagi-managed pane and can safely talk to the local Nagi socket.

With the skill installed, an agent can:

  • inspect workspaces, tabs, panes, and neighboring agents
  • split panes and run commands without stealing focus
  • read pane output and recent logs
  • wait for servers, tests, or another agent to finish
  • start helper agents in sibling panes

The skill is not a separate app or service. It is a markdown instruction file for agents.

Install it

Section titled “Install it”

Install the skill with npx skills:

Terminal window
npx skills add Cod-Hash-Studios/nagi --skill nagi -g

The -g flag installs it globally for supported agents. Omit -g to install it into the current project.

Use the repository copy as the manual fallback and source of truth:

https://github.com/Cod-Hash-Studios/nagi/blob/main/SKILL.md

For agents with a skill system, install that file as a skill named nagi. For agents without a skill system, paste the file into the agent’s project or user instructions.

After installation, start the agent inside Nagi:

Terminal window
nagi
claude

Or use any other coding agent in a Nagi pane. The important part is that the agent process runs inside Nagi, so NAGI_ENV=1 is available.

Safety rule

Section titled “Safety rule”

The skill starts with one guardrail: if NAGI_ENV=1 is not set, the agent should stop and say it is not running inside a Nagi-managed pane.

This prevents an agent outside Nagi from trying to control a session it does not own.

Agent-facing reference

Section titled “Agent-facing reference”

The full command guide lives in the skill file itself. It covers pane IDs, pane split, pane run, pane read, wait output, wait agent-status, workspace and tab commands, and coordination recipes.

Read the source file here:

Open SKILL.md on GitHub →