Agent skill

Oia Manifest

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

Install Oia Manifest

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a claude-code

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

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest --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/oia-manifest .claude/skills/oia-manifest && 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/

Paste into Claude Code

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .claude/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/metaharness.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude-plugin/skills/oia-manifest .agents/skills/oia-manifest && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .agents/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/metaharness.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude-plugin/skills/oia-manifest .cursor/skills/oia-manifest && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .cursor/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ruvnet/metaharness.git --path .claude-plugin/skills/oia-manifest

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/metaharness.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude-plugin/skills/oia-manifest .gemini/skills/oia-manifest && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .gemini/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

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

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .github/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/metaharness --skill oia-manifest -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ruvnet/metaharness oia-manifest --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/metaharness.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude-plugin/skills/oia-manifest .opencode/skills/oia-manifest && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "oia-manifest" agent skill from https://github.com/ruvnet/metaharness/tree/main/.claude-plugin/skills/oia-manifest into .opencode/skills/oia-manifest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oia-manifest", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: oia-manifest
GitHub stars: 696
Token cost: ~910 tokens
SKILL.md length: 256 words
Files: 1
Skills in repo: 14
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

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

Tasks that involve Architecture decision records
SKILL.md covers What it does, Why a manifest, not a host…, Usage from Codex and Equivalent CLI, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Tasks that involve MCP servers

What it does

Oia Manifest is an agent skill from ruvnet/metaharness. Emit .harness/oia-manifest.json declaring layer alignment with the OIA v0.1 9-layer reference architecture. Self-describes the harness's MCP wiring, witness signing, audit log, identity posture (always 'none' at v0.1). --check verifies an existing manifest, --dry-run prints without writing, --json emits to stdout.

Its SKILL.md is about 910 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 Agent Workflows, covering Architecture decision records and MCP servers. It works with 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 Architecture decision records
Tasks that involve MCP servers

Example prompts

“s MCP wiring, witness signing, audit log, identity posture (always”
“/oia-manifest”

What it can do on your machine

Read from SKILL.md and the folder at commit e0dfd44. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- oia.agentics.org
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

Oia Manifest loads about 910 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 256 words of instructions outside code blocks.

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

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 e0dfd44, republished under its MIT licence (© ruvnet). 256 words, ~910 tokens.

Download SKILL.mdSave it as .claude/skills/oia-manifest/SKILL.md (or your agent's skills folder).

name: oia-manifest
description: Emit .harness/oia-manifest.json declaring layer alignment with the OIA v0.1 9-layer reference architecture. Self-describes the harness's MCP wiring, witness signing, audit log, identity posture (always 'none' at v0.1). --check verifies an existing manifest, --dry-run prints without writing, --json emits to stdout.

oia-manifest

Codex skill: emit/validate the OIA cross-cutting manifest layer (ADR-034, iter 121 → iter 122).

What it does

Emits .harness/oia-manifest.json — the harness's self-assessment against the Open Intelligence Architecture (OIA) v0.1 9-layer reference model published by the Agentics Foundation at https://oia.agentics.org.

The manifest declares:

9 layer alignments — L1 physicalCompute → L9 humanAndBrowserInterface, each full / partial / none / not-applicable
6 horizontal spans — security · observability · identity · governance · policyEnforcement · interoperability, each full / partial / none with an implementation reference (file path or ADR number)
4 adjacent standards — mcp, a2a, acp, agentProtocol with current mode + wiring notes
discoveryEndpoint + registryUrl (both null at v0.1; OIA has no registry yet)

Why a manifest, not a host adapter?

OIA at v0.1 has no runtime and no wire protocol — it's a vendor-neutral vocabulary for assessing system alignment. The right plug-in shape is a static cross-cutting manifest (ADR-034 Decision: Option B). It plugs in ABOVE the host adapter contract and BELOW the MCP policy gate.

Usage from Codex

/oia-manifest path=./my-harness
/oia-manifest path=./my-harness check=true
/oia-manifest path=./my-harness dry-run=true

Equivalent CLI

bash

harness oia-manifest ./my-harness                # write .harness/oia-manifest.json
harness oia-manifest ./my-harness --check        # validate existing manifest
harness oia-manifest ./my-harness --dry-run      # stdout, no file write
harness oia-manifest ./my-harness --json         # stdout JSON

Verdict + exit codes (--check)

Verdict	Exit	Meaning
`PASS`	0	manifest shape ok, oiaVersion echoed
`DRIFT`	1	shape mismatch — per-field reasons surfaced
`FAIL no manifest`	2	`.harness/oia-manifest.json` missing

Sample manifest (excerpt)

json

{
  "schema": 1,
  "oiaVersion": "0.1",
  "harnessId": "my-bot@0.1.0",
  "layerAlignment": {
    "L4_toolsAndIntegrations": "full",
    "L7_governanceAndPolicy": "full"
  },
  "horizontalSpans": {
    "identity": { "status": "none", "implementation": null },
    "security": { "status": "full", "implementation": "mcp-policy.json + ADR-022" }
  },
  "adjacentStandards": {
    "mcp": { "mode": "local", "policyPath": ".harness/mcp-policy.json" }
  },
  "discoveryEndpoint": null,
  "registryUrl": null
}

Pre-emptive composition rule (ADR-034 §120)

If a future OIA identity primitive ever wants to widen an MCP permission, the composition is denied at the policy gate. The mcp-policy.json default-deny posture is not negotiable for external identity claims.

validate-harness (iter 22) — release-readiness umbrella
threat-model (iter 114) — MCP threat-model for PR/compliance review
diag-harness (iter 70) — kernel-version skew check

Files

Just SKILL.md in .claude-plugin/skills/oia-manifest of ruvnet/metaharness.

Open the folder on GitHubat commit e0dfd44

Compare with similar skills

Oia Manifest 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.

Oia Manifest compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Oia Manifest this skillruvnet/metaharness	696	—	~910	Automated safety check: Pass	MIT	yesterday
MCP Google Map Projectcablate/mcp-google-map	469	—	~774	Automated safety check: Pass	MIT	14 days ago
Memory686f6c61/alfred-dev	117	—	~601	Automated safety check: Pass	MIT	1 mo ago
Ogham Researchogham-mcp/ogham-mcp	115	—	~1.4k	Automated safety check: Pass	MIT	11 days ago
Design MCP Servercyanheads/pubmed-mcp-server	158	—	~22k	Automated safety check: Pass	Apache-2.0	2 days ago
Crush Configurationcharmbracelet/crush	29k	—	~3.7k	Automated safety check: Pass	Custom licence	today

Similar skills

MCP Google Map Project
cablate/mcp-google-map
Project knowledge for developing and maintaining @cablate/mcp-google-map.
469 GitHub stars~774 tokensUpdated 14 days ago
Agent WorkflowsAuto-check passed
Memory
686f6c61/alfred-dev
This skill should be used when the user asks to record a design decision, search past project decisions, inspect the Alfred memory timeline, or work with the alfred-memory MCP server.
117 GitHub stars~601 tokensUpdated 1 mo ago
Agent WorkflowsAuto-check passed
Ogham Research
ogham-mcp/ogham-mcp
Structured memory capture for Ogham shared memory. An agent skill from ogham-mcp/ogham-mcp.
115 GitHub stars~1.4k tokensUpdated 11 days ago
Agent WorkflowsAuto-check passed
Design MCP Server
cyanheads/pubmed-mcp-server
Design the tool surface, resources, and service layer for a new MCP server.
158 GitHub stars~22k tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
29k GitHub stars~3.7k tokensUpdated today
Agent WorkflowsAuto-check passed
PicoClaw Agent
sipeed/picoclaw
Answers questions about running and changing PicoClaw, from onboarding and model selection to MCP server setup, skill loading and scheduled jobs.
30k GitHub stars~7.2k tokensUpdated yesterday
Agent WorkflowsAuto-check: notes

Questions about Oia Manifest

What does Oia Manifest do?

Emit .harness/oia-manifest.json declaring layer alignment with the OIA v0.1 9-layer reference architecture. Oia Manifest is an agent skill from ruvnet/metaharness.1 9-layer reference architecture.

When should I use Oia Manifest?

Oia Manifest fits situations like: tasks that involve Architecture decision records; tasks that involve MCP servers.

How do I install Oia Manifest in Claude Code?

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

How do I install Oia Manifest in Codex?

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

Can I use Oia Manifest 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 oia-manifest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oia-manifest, .gemini/skills/oia-manifest, .github/skills/oia-manifest and .opencode/skills/oia-manifest in your project.

What does Oia Manifest need to run?

SKILL.md names no scripts, command-line tools or credentials: Oia Manifest is instructions for the agent only.

Does Oia Manifest access the network?

SKILL.md names 1 domain. As links in the text: oia.agentics.org. This is read from the text; nothing was executed.

Is Oia Manifest 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 Oia Manifest use?

Oia Manifest 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 Oia Manifest use?

About 910 tokens (SKILL.md is roughly 3.6k 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 Oia Manifest?

Skills that share tags, products or a category with Oia Manifest: MCP Google Map Project (cablate/mcp-google-map, 469 stars), Memory (686f6c61/alfred-dev, 117 stars), Ogham Research (ogham-mcp/ogham-mcp, 115 stars) and Design MCP Server (cyanheads/pubmed-mcp-server, 158 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oia Manifest?

ruvnet (a GitHub user) maintains it in ruvnet/metaharness, which has 696 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 10, 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.

Install Oia Manifest

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

oia-manifest

What it does

Why a manifest, not a host adapter?

Usage from Codex

Equivalent CLI

Verdict + exit codes (--check)

Sample manifest (excerpt)

Pre-emptive composition rule (ADR-034 §120)

Related skills

See also

Files

Compare with similar skills

Similar skills

More from ruvnet/metaharness

Related

Questions about Oia Manifest