Agent skill

Example Harness

by ruvnet in ruvnet/metaharness

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…

MITAuto-check passedDevOps & Cloud

Install Example Harness

skills CLI
$ npx skills add ruvnet/metaharness --skill example-harness -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/metaharness example-harness --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/metaharness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude-plugin/skills/example-harness .claude/skills/example-harness && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
example-harness
GitHub stars
688
Token cost
~735 tokens
SKILL.md length
200 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Tasks that involve Project scaffolding
  • SKILL.md covers Install, Use, The 18 packages and After scaffolding
  • Calls npx, curl and npm; reaches raw.githubusercontent.com
  • Tasks that involve CI/CD

What it does

Example Harness is an agent skill from ruvnet/metaharness. 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).

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Project scaffolding, CI/CD and Trading and backtesting. It works with GitHub Actions and Model Context Protocol. The repository describes itself as: 🛠️ The meta-harness for AI agents — scaffold your own focused, branded agent harness with its own npx CLI, MCP server, memory, learning loop, and witness-signed releases. Works… The licence is MIT.

When your agent uses it

  • Tasks that involve Project scaffolding
  • Tasks that involve CI/CD
  • Tasks that involve Trading and backtesting

Example prompts

  • “/example-harness”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 53a251d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • curl
    • npm
    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com

    Also links to:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Example Harness loads about 735 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~735

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/metaharness at commit 53a251d, republished under its MIT licence (© ruvnet). 200 words, ~735 tokens.

Download SKILL.mdSave it as .claude/skills/example-harness/SKILL.md (or your agent's skills folder).
name
example-harness
description
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-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

bash
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:

bash
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

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

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude-plugin/skills/example-harness of ruvnet/metaharness.

Open the folder on GitHubat commit 53a251d

Compare with similar skills

Example Harness next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Example Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Example Harness this skillruvnet/metaharness688—~735Automated safety check: PassMIT
MCP Server Trello Releasedelorenj/mcp-server-trello446—~3.5kAutomated safety check: PassMIT
Docs Tooling Notionlangchain-ai/docs424—~1.7kAutomated safety check: PassMIT
Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template786—~5.9kAutomated safety check: NotesMIT
Publishingadeze/raindrop-mcp188—~398Automated safety check: PassMIT
gh-aw Custom Engine Implementationgithub/gh-aw5.3k—~1.9kAutomated safety check: PassMIT

Similar skills

  • MCP Server Trello Release

    delorenj/mcp-server-trello

    Canonical build → release → tag → publish procedure for the @delorenj/mcp-server-trello repo.

    446 GitHub stars~3.5k tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Docs Tooling Notion

    langchain-ai/docs

    Official

    Document new or changed docs-team tooling on the Notion tooling pages.

    424 GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Publishing

    adeze/raindrop-mcp

    Publishing and release workflow with semantic-release and GitHub Actions

    188 GitHub stars~398 tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Adds and tests declarative, behavior-defined agentic engines in GitHub Agentic Workflows, touching Go infrastructure only when the declarative model falls short.

    5.3k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Claude Docs Consultant

    centminmod/my-claude-code-setup

    Consult official Claude Code documentation from code.claude.com using selective fetching.

    2.7k GitHub stars~959 tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed

More from ruvnet/metaharness

All 14 skills in this repo
  • Create Harness

    ruvnet/metaharness

    Scaffold your own focused AI agent harness — pick host (Claude Code, Codex, pi.dev, Hermes), template, agents, skills, and ship a npm-publishable harness with its own npx CLI.

    688 GitHub stars~777 tokensUpdated yesterday
    Auto-check passed
  • Compare Harnesses

    ruvnet/metaharness

    Diff two scaffolded harnesses (ADR-031). An agent skill from ruvnet/metaharness.

    688 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Diag Harness

    ruvnet/metaharness

    Kernel-version skew check (ADR-027). An agent skill from ruvnet/metaharness.

    688 GitHub stars~835 tokensUpdated yesterday
    Auto-check passed
  • Oia Manifest

    ruvnet/metaharness

    Emit .harness/oia-manifest.json declaring layer alignment with the OIA v0.1 9-layer reference architecture.

    688 GitHub stars~910 tokensUpdated yesterday
    Auto-check passed
  • Repo Genome

    ruvnet/metaharness

    7-section readiness scorecard for a LOCAL repo. An agent skill from ruvnet/metaharness.

    688 GitHub stars~772 tokensUpdated yesterday
    Auto-check passed
  • Score Harness

    ruvnet/metaharness

    5-dimension scorecard (0-100, grade A/B/C/F) for a scaffolded harness.

    688 GitHub stars~613 tokensUpdated yesterday
    Auto-check passed

Questions about Example Harness

What does Example Harness do?

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…. Example Harness is an agent skill from ruvnet/metaharness.dev, OpenClaw, RVM, Copilot, OpenCode, GitHub Actions) + 10 vertical pods (devops, research, trading, support, legal, coding, education, sales, gaming, repo-maintainer).

When should I use Example Harness?

Example Harness fits situations like: tasks that involve Project scaffolding; tasks that involve CI/CD; tasks that involve Trading and backtesting.

How do I install Example Harness in Claude Code?

Run `npx skills add ruvnet/metaharness --skill example-harness -a claude-code`. Or copy the skill folder (.claude-plugin/skills/example-harness in ruvnet/metaharness) into .claude/skills/example-harness in your project. Claude Code loads it when a task matches its description.

How do I install Example Harness in Codex?

Run `npx skills add ruvnet/metaharness --skill example-harness -a codex`. Or copy the skill folder (.claude-plugin/skills/example-harness in ruvnet/metaharness) into .agents/skills/example-harness in your project. Codex loads it when a task matches its description.

Can I use Example Harness in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/metaharness --skill example-harness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/example-harness, .gemini/skills/example-harness, .github/skills/example-harness and .opencode/skills/example-harness in your project.

What does Example Harness need to run?

Going by SKILL.md and its folder, Example Harness needs the command-line tools its instructions call (npx, curl, npm and claude). Our summary lists: Node.js.

Does Example Harness access the network?

SKILL.md names 2 domains. In commands or code: raw.githubusercontent.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Example Harness safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Example Harness use?

Example Harness is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Example Harness use?

About 735 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Example Harness?

Skills that share tags, products or a category with Example Harness: MCP Server Trello Release (delorenj/mcp-server-trello, 446 stars), Docs Tooling Notion (langchain-ai/docs, 424 stars), Prepare Cloudflare Production Deployment (LubomirGeorgiev/cloudflare-workers-nextjs-saas-template, 786 stars) and Publishing (adeze/raindrop-mcp, 188 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Example Harness?

ruvnet (a GitHub user) maintains it in ruvnet/metaharness, which has 688 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 6, 2026.

Source: ruvnet/metaharness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.