How do I install the Example Harness skill?

Run npx skillmds@latest add ruvnet/example-harness in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Example Harness safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Example Harness?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Example Harness free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Example Harness?

ruvnet (@ruvnet) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Example Harness by ruvnet — Agent Skill

Name: Example Harness
Rating: 4.2 (5 reviews)
Author: ruvnet

Example Harness

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).

ruvnet be80063 2.9 KB Updated Sep 10, 2026

File contents

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)

Package	Scaffolds
`@metaharness/claude-code`	Claude Code workspace + plugin
`@metaharness/codex`	OpenAI Codex
`@metaharness/hermes`	Hermes cli-config
`@metaharness/pi-dev`	pi.dev AGENTS.md
`@metaharness/openclaw`	OpenClaw `.openclaw/`
`@metaharness/rvm`	RVM deployment partition
`@metaharness/copilot`	VSCode / Copilot `mcp.json`
`@metaharness/opencode`	OpenCode `.opencode/`
`@metaharness/github-actions`	GitHub Actions CI/CD (non-interactive)

Vertical workflows (ready-made multi-agent pods)

Package	Scaffolds
`@metaharness/devops`	incident response
`@metaharness/research`	multi-source dossier
`@metaharness/trading`	quant trading (paper-by-default)
`@metaharness/support`	customer support
`@metaharness/legal`	contract redline (drafts only)
`@metaharness/coding`	engineering pod
`@metaharness/education`	tutor pod
`@metaharness/sales`	sales pipeline pod
`@metaharness/gaming`	game-design pod
`@metaharness/repo-maintainer`	OSS 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.

---name: example-harnessdescription: 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).---# example-harnessOne-command scaffolding from the 18 **published** `@metaharness/*` examplepackages — the fastest path from a use-case to a working harness, notemplate/host flags to remember.Where [`create-harness`](../create-harness/) walks the full wizard, thisskill maps a use-case straight onto a published npm wrapper. Each wrappershells out to `metaharness@latest` with the correct `--template` + `--host`flags, so the result is byte-identical to the full CLI invocation.## Install```bashmkdir -p ~/.codex/skills/example-harnesscurl -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:```bashnpx --yes @metaharness/<package>@latest <name>```## The 18 packages**Host integrations** (scaffold a workspace wired for one runtime)| Package | Scaffolds ||---|---|| `@metaharness/claude-code` | Claude Code workspace + plugin || `@metaharness/codex` | OpenAI Codex || `@metaharness/hermes` | Hermes cli-config || `@metaharness/pi-dev` | pi.dev AGENTS.md || `@metaharness/openclaw` | OpenClaw `.openclaw/` || `@metaharness/rvm` | RVM deployment partition || `@metaharness/copilot` | VSCode / Copilot `mcp.json` || `@metaharness/opencode` | OpenCode `.opencode/` || `@metaharness/github-actions` | GitHub Actions CI/CD (non-interactive) |**Vertical workflows** (ready-made multi-agent pods)| Package | Scaffolds ||---|---|| `@metaharness/devops` | incident response || `@metaharness/research` | multi-source dossier || `@metaharness/trading` | quant trading (paper-by-default) || `@metaharness/support` | customer support || `@metaharness/legal` | contract redline (drafts only) || `@metaharness/coding` | engineering pod || `@metaharness/education` | tutor pod || `@metaharness/sales` | sales pipeline pod || `@metaharness/gaming` | game-design pod || `@metaharness/repo-maintainer` | OSS repo maintainer |## After scaffolding```bashcd <name> && npm installnpx harness doctor # health-checknpx harness validate # full umbrella gate```Every scaffold ships a `.claude-plugin/plugin.json`, so it also loads as aClaude Code plugin: `claude -p --plugin-dir <name> "..."`.Per-package deep-dive gists: see[`examples-packages/GISTS.md`](https://github.com/ruvnet/agent-harness-generator/blob/main/examples-packages/GISTS.md).

Frequently asked questions