How to Install the Agent Skills

The @antora-tracer/core npm package ships six Agent Skills that teach an AI assistant to write, review, and improve traceable content. The skills live in the skills/ directory of the installed package.

Before you start

Install antora-tracer as a regular dependency:

npm install @antora-tracer/core

The skills are now in node_modules/@antora-tracer/core/skills/.

Install for pi

Option A — install antora-tracer as a pi package so pi auto-loads the skills:

pi install npm:@antora-tracer/core

Option B — keep the regular npm install and point pi at the skills directory. Create or extend .pi/settings.json in your project:

{
  "skills": ["../node_modules/@antora-tracer/core/skills"]
}

The ../ prefix is required because paths in .pi/settings.json resolve relative to the .pi/ directory.

Install for Claude Code

Copy the skills into Claude Code’s skills directory:

cp -r node_modules/@antora-tracer/core/skills/* ~/.claude/skills/

Alternatively, symlink them so package updates are picked up automatically:

for s in requirements-writing use-case-engineering review-architecture-diagrams semantic-relation-review abstraction-level-review write-item; do
  ln -s "$(pwd)/node_modules/@antora-tracer/core/skills/$s" ~/.claude/skills/$s
done

Install for OpenAI Codex

Copy the skills into the Codex skills directory:

cp -r node_modules/@antora-tracer/core/skills/* ~/.codex/skills/

Install with the CLI installer

antora-tracer skills install handles multiple harnesses in one step. Without arguments, it prompts interactively for your selection. With explicit harness names, it installs without further prompting:

antora-tracer skills install
antora-tracer skills install claude codex
antora-tracer skills install pi

The installer copies every bundled skill directory into each selected harness’s per-user destination and never overwrites existing skills unless --overwrite is specified. For Pi, the command explains that installing the package through Pi’s package manager already auto-loads the skills; the installer only copies standalone skill directories when the user explicitly selects pi.

See antora-tracer skills install --help and the CLI reference for details.

Verify the install

Ask your agent to list its available skills. Confirm the six antora-tracer skills appear:

  • requirements-writing

  • use-case-engineering

  • review-architecture-diagrams

  • semantic-relation-review

  • abstraction-level-review

  • write-item

See Product Structure for how the skills relate to the core extension.