AugmentClaude

Example Harness

Scaffold an AI agent harness in one command from pre-built templates.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/example-harness-ruvnet/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Scaffold a ready-made AI agent harness in one command from the 19 published @metaharness/* example packages — 9 host integrations (Claude Code, Codex, Hermes, pi.dev, OpenClaw, RVM, Copilot, OpenCode, GitHub Actions) + 10 vertical pods (devops, research, trading, support, legal, coding, education, sales, gaming, repo-maintainer).

What this skill does

example-harness

One-command scaffolding from the 18 published @metaharness/* example packages — the fastest path from a use-case to a working harness, no template/host flags to remember.

Where create-harness walks the full wizard, this skill maps a use-case straight onto a published npm wrapper. Each wrapper shells out to metaharness@latest with the correct --template + --host flags, so the result is byte-identical to the full CLI invocation.

Install

mkdir -p ~/.codex/skills/example-harness
curl -fsSL https://raw.githubusercontent.com/ruvnet/agent-harness-generator/main/.codex/skills/example-harness/skill.toml \
  -o ~/.codex/skills/example-harness/skill.toml

No MCP server needed — the wrapper packages run via npx.

Use

/example-harness

Codex prompts for the package + a directory name, then runs:

npx --yes @metaharness/<package>@latest <name>

The 18 packages

Host integrations (scaffold a workspace wired for one runtime)

PackageScaffolds
@metaharness/claude-codeClaude Code workspace + plugin
@metaharness/codexOpenAI Codex
@metaharness/hermesHermes cli-config
@metaharness/pi-devpi.dev AGENTS.md
@metaharness/openclawOpenClaw .openclaw/
@metaharness/rvmRVM deployment partition
@metaharness/copilotVSCode / Copilot mcp.json
@metaharness/opencodeOpenCode .opencode/
@metaharness/github-actionsGitHub Actions CI/CD (non-interactive)

Vertical workflows (ready-made multi-agent pods)

PackageScaffolds
@metaharness/devopsincident response
@metaharness/researchmulti-source dossier
@metaharness/tradingquant trading (paper-by-default)
@metaharness/supportcustomer support
@metaharness/legalcontract redline (drafts only)
@metaharness/codingengineering pod
@metaharness/educationtutor pod
@metaharness/salessales pipeline pod
@metaharness/gaminggame-design pod
@metaharness/repo-maintainerOSS repo maintainer

After scaffolding

cd <name> && npm install
npx harness doctor      # health-check
npx harness validate    # full umbrella gate

Every scaffold ships a .claude-plugin/plugin.json, so it also loads as a Claude Code plugin: claude -p --plugin-dir <name> "...".

Per-package deep-dive gists: see examples-packages/GISTS.md.

Related skills