Agent skill

Repo Harness

by Ancienttwo in Ancienttwo/repo-harness

Route explicit repo-harness commands and active harness work.

MITAuto-check passed

Install Repo Harness

skills CLI
$ npx skills add Ancienttwo/repo-harness --skill repo-harness -a claude-code

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

GitHub CLI
$ gh skill install Ancienttwo/repo-harness repo-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).

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

Facts

Skill name
repo-harness
GitHub stars
434
Token cost
~365 tokens
SKILL.md length
166 words
Files
5,003 (incl. scripts, references, assets)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Route explicit repo-harness commands and active harness work.

  • Works in 5 steps: setup — bind the mode and target repo,… → plan — use repo-harness-check for scoped… → execute — assign a bounded brief and… → …

What it does

Repo Harness is an agent skill from Ancienttwo/repo-harness. Route explicit repo-harness commands and active harness work. Exclude ordinary questions, quoted reports, and general product work.

Its SKILL.md is about 370 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5008 other files, including scripts, reference files and assets (for example `.ai/context/capability-source-map.json`, `.ai/context/context-map.json` and `.ai/harness/brain-manifest.json`).

The repository describes itself as: File-backed workflow harness for reliable Claude Code and Codex sessions. The licence is MIT.

Example prompts

  • “/repo-harness”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. setup — bind the mode and target repo, then assign repo-harness-setup.
  2. plan — use repo-harness-check for scoped design or plan review.
  3. execute — assign a bounded brief and owning paths. Load worker techniques
  4. verify — use repo-harness-check to assess recorded checks and risk.
  5. handoff — read references/handoff.md only when work must resume later.

What it can do on your machine

Read from SKILL.md and the folder at commit 461e054. 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

    Ships 1 file in scripts/, which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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

Repo Harness loads about 365 tokens when it runs, and up to ~28k if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 166 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~365
With references · SKILL.md plus every file in references/, read only if the agent opens them
~28k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Ancienttwo/repo-harness at commit 461e054, republished under its MIT licence (© Ancienttwo). 166 words, ~365 tokens.

Download SKILL.mdSave it as .claude/skills/repo-harness/SKILL.md (or your agent's skills folder). This skill also uses 5002 other files; get the full folder from GitHub.
name
repo-harness
description
Route explicit repo-harness commands and active harness work. Exclude ordinary questions, quoted reports, and general product work.
when_to_use
repo-harness

repo-harness

Bot entrypoint. Resolve scope, worker ownership and the authorized outcome. Use repo-harness state resolve --json when active harness state is needed. Treat the returned state as authority; load only the files it names. Load the required herdr skill before controlling Herdr panes or agents. Only an agent inside a Herdr pane may run those control commands.

  1. setup — bind the mode and target repo, then assign repo-harness-setup.
  2. plan — use repo-harness-check for scoped design or plan review. Use repo-harness-product only for requested PRD, Sprint or Goal work.
  3. execute — assign a bounded brief and owning paths. Load worker techniques from repo-harness-test or repo-harness-architecture only when needed. Use repo-harness-ship for explicitly authorized publication.
  4. verify — use repo-harness-check to assess recorded checks and risk.
  5. handoff — read references/handoff.md only when work must resume later.

Keep main publication, deletion, credentials/permissions and release/production within their separate authorization boundaries. Ordinary work needs scoped changes, verification and a PR description. Load architecture or command details only when the task needs them.

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

Files

SKILL.md and 5,002 other files (scripts, references, assets) in the repository root of Ancienttwo/repo-harness.

  • SKILL.md
  • .ai/context/capability-source-map.json
  • .ai/context/context-map.json
  • .ai/harness/architecture/.gitkeep
  • .ai/harness/brain-manifest.json
  • .ai/harness/checks/.gitkeep
  • .ai/harness/checks/candidate-bound-global-runtime-reconciliation.pre-fix.log
  • .ai/harness/checks/global-architecture-pre-fix.log
  • .ai/harness/checks/pre-fix-global-runtime-env.log
  • .ai/harness/checks/pre-fix-init-command-env.log
  • .ai/harness/checks/pre-fix-mcp-oauth-client-ttl.log
  • .ai/harness/failures/.gitkeep
  • .ai/harness/failures/architecture-runtime-owner-pre-fix.log
  • .ai/harness/failures/operator-authority-pre-fix.log
  • .ai/harness/failures/operator-connector-acceptance-repair-pre-fix.log
  • … and 4,988 more

Open the folder on GitHubat commit 461e054

Compare with similar skills

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

Repo Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Harness this skillAncienttwo/repo-harness434—~365Automated safety check: PassMIT
OmniRoute Routing CLIdiegosouzapw/OmniRoute75k—~342Automated safety check: PassMIT
OmniRoute Combo Routingdiegosouzapw/OmniRoute75k—~2.1kAutomated safety check: PassMIT
Intelligence Routeruvnet/ruflo74k—~874Automated safety check: NotesMIT
Modeling Activation MetricsPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence
SPA Routes and Featureslobehub/lobehub83k—~3.2kAutomated safety check: PassCustom licence

Similar skills

  • OmniRoute Routing CLI

    diegosouzapw/OmniRoute

    Creates, switches, and inspects OmniRoute model-routing combos, plus a suggestion command with cost and latency constraints.

    75k GitHub stars~342 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • OmniRoute Combo Routing

    diegosouzapw/OmniRoute

    Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

    75k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Intelligence Route

    ruvnet/ruflo

    Route tasks via the 3-tier model selector and learned patterns; emits a routing rationale via hooksexplain

    74k GitHub stars~874 tokensUpdated today
    DevelopmentAuto-check: notes
  • Official

    Build reusable activation models — an activation-rate metric and a per-user/per-account activated flag — on either PostHog data-warehouse views (HogQL) or an external dbt project.

    40k GitHub stars~1.4k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Explains LobeHub's split between src/routes page segments and src/features domain code, and where router config, redirects and platform adapters belong.

    83k GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Summarize Activity

    alpinejs/alpine

    Summarize recent GitHub activity — discussions, PRs, issues, events, traffic — into an actionable report so you can stay on top of the project without reading everything.

    32k GitHub stars~1.6k tokensUpdated 5 days ago
    Backend & APIsAuto-check: notes

More from Ancienttwo/repo-harness

All 12 skills in this repo
  • Development Scheduler

    Ancienttwo/repo-harness

    在 repo-harness session 或 Bot 中通过 Herdr 调度开发任务、跟进阻碍、组织独立审查和安全交接;用于多角色开发协调,不用于单次代码修改或只读状态查询。

    434 GitHub stars~703 tokensUpdated today
    Auto-check passed
  • Repo Harness Chatgpt

    Ancienttwo/repo-harness

    Canonical rule owner for repo-harness ChatGPT integration -- Oracle-first browser/GPT Pro consult and continuation, advisory orchestration, MCP Connector setup, MCP bridge planning handoff, and…

    434 GitHub stars~587 tokensUpdated today
    Auto-check passed
  • Repo Harness Setup

    Ancienttwo/repo-harness

    Canonical rule owner for installing, migrating, upgrading, repairing, scaffolding, and capability-configuring the repo-harness workflow in a repository.

    434 GitHub stars~474 tokensUpdated today
    Auto-check passed
  • Repo Harness Ship

    Ancienttwo/repo-harness

    Close out verified harness work only when the user explicitly asks to commit, push, open a PR, merge, or clean merged worktrees.

    434 GitHub stars~251 tokensUpdated today
    Auto-check passed
  • Repo Harness

    Ancienttwo/repo-harness

    Eval-only bounded frontier stress test for complex repo-harness planning; never installed as a managed Skill.

    434 GitHub stars~533 tokensUpdated today
    Auto-check passed
  • Repo Harness Check

    Ancienttwo/repo-harness

    Plan scoped harness work, review a plan, or assess recorded checks and risk.

    434 GitHub stars~354 tokensUpdated today
    Auto-check passed

Questions about Repo Harness

What does Repo Harness do?

Route explicit repo-harness commands and active harness work. Repo Harness is an agent skill from Ancienttwo/repo-harness. Route explicit repo-harness commands and active harness work.

How do I install Repo Harness in Claude Code?

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

How do I install Repo Harness in Codex?

Run `npx skills add Ancienttwo/repo-harness --skill repo-harness -a codex`. Or copy the skill folder (the Ancienttwo/repo-harness repository) into .agents/skills/repo-harness in your project. Codex loads it when a task matches its description.

Can I use Repo 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 Ancienttwo/repo-harness --skill repo-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/repo-harness, .gemini/skills/repo-harness, .github/skills/repo-harness and .opencode/skills/repo-harness in your project.

What does Repo Harness need to run?

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

Does Repo Harness access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Repo 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Repo Harness use?

Repo Harness is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Repo Harness use?

About 365 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 28k tokens, read only when the agent opens those files.

What are the alternatives to Repo Harness?

Skills that share tags, products or a category with Repo Harness: OmniRoute Routing CLI (diegosouzapw/OmniRoute, 75k stars), OmniRoute Combo Routing (diegosouzapw/OmniRoute, 75k stars), Intelligence Route (ruvnet/ruflo, 74k stars) and Modeling Activation Metrics (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Harness?

Ancienttwo (a GitHub user) maintains it in Ancienttwo/repo-harness, which has 434 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 10, 2026.

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