Agent skill

Harness Adapters

by kunchenguid in kunchenguid/firstmate

Agent-only reference for firstmate harness operations. An agent skill from kunchenguid/firstmate.

MITAuto-check passed

Install Harness Adapters

skills CLI
$ npx skills add kunchenguid/firstmate --skill harness-adapters -a claude-code

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

GitHub CLI
$ gh skill install kunchenguid/firstmate harness-adapters --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/kunchenguid/firstmate.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/harness-adapters .claude/skills/harness-adapters && 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
harness-adapters
GitHub stars
7.7k
Token cost
~1.7k tokens
SKILL.md length
536 words
Files
18 (incl. references)
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Agent-only reference for firstmate harness operations. An agent skill from kunchenguid/firstmate.

  • SKILL.md covers Path contract, Non-negotiable safety, Detection and Operation-to-reference matrix
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Harness Adapters is an agent skill from kunchenguid/firstmate. Agent-only reference for firstmate harness operations. Use before spawning or recovering a crewmate or secondmate, handling a trust dialog, sending a harness-specific skill invocation, interrupting or exiting an agent, resuming an exited agent, or verifying a new harness adapter. Contains verified facts for claude, codex, opencode, pi, pi-signed, grok, kimi, cursor, gemini, muse, rovo, omp, agy, and devin.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `references/common/control-and-recovery.md`, `references/common/dispatch.md` and `references/common/model-and-effort.md`).

It works with Kimi. The repository describes itself as: Talk to one agent. Ship with a crew. The licence is MIT.

Example prompts

  • “/harness-adapters”

What it can do on your machine

Read from SKILL.md and the folder at commit 19fcbbd. 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 json).

    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

Harness Adapters loads about 1.7k tokens when it runs, and up to ~30k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 536 words of instructions outside code blocks.

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

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 kunchenguid/firstmate at commit 19fcbbd, republished under its MIT licence (© kunchenguid). 536 words, ~1,694 tokens.

Download SKILL.mdSave it as .claude/skills/harness-adapters/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
harness-adapters
description
Agent-only reference for firstmate harness operations. Use before spawning or recovering a crewmate or secondmate, handling a trust dialog, sending a harness-specific skill invocation, interrupting or exiting an agent, resuming an exited agent, or verifying a new harness adapter. Contains verified facts for claude, codex, opencode, pi, pi-signed, grok, kimi, cursor, gemini, muse, rovo, omp, agy, and devin.
user-invocable
false
metadata.internal
true

harness-adapters

This is the one skill, trigger, and routing owner for harness-specific Firstmate operations. Load this router first, then exactly the common reference and one harness reference selected below. When an action spans rows, load the union once rather than every reference. Files under references/ are resources of this skill, not additional catalogued skills.

Path contract

The skill directory is the directory containing this SKILL.md. Resolve on-demand reference links and relative links to their executable, documentation, or sibling-skill owners against the skill directory, including links named by a nested reference. Operational paths keep the context named by their owner: config/ and active-home settings belong to the active Firstmate home, state/ belongs to that home, and project settings such as .claude/settings.json belong to the target project.

Non-negotiable safety

Never dispatch a crewmate or secondmate on an unverified adapter. If config/crew-harness or config/secondmate-harness names one, tell the captain under ../../../AGENTS.md section 9 that the requested worker runtime is not verified, use firstmate's own verified runtime for current work, and ask only whether to verify the requested runtime for future work. Do not pause current work for that choice.

On unknown, ask the captain instead of guessing. A current captain override beats detection, while a per-task override governs only that dispatch. For recovery and control, use the exact harness= in state/<id>.meta; never infer it from a model or provider.

Deliver lifecycle actions only through ../../../bin/fm-control.sh <task-id> interrupt|exit|relaunch. Never type an interrupt key or exit command through fm-send, where routing-marked lifecycle text becomes chat. Trust handling is complete only when inspection proves the target started processing its instructions; delivery success alone is not proof. Muse, Gemini, AGY, and Devin are verified only for crewmate and scout work, never a secondmate or primary.

Show full SKILL.md (248 more words)Show less

Detection

../../../bin/fm-harness.sh prints firstmate's own harness from verified environment markers and process ancestry, and owns how they combine. A marker names its harness, but a structural ancestor of a different harness outranks it, because a marker is ordinary environment state a child or a multiplexer can retain while ancestry is what proves who owns the process tree. Only FM_PI_HARNESS=pi-signed at the launch boundary together with PI_CODING_AGENT=true selects Pi-signed; shared unmarked launcher ancestry remains Pi. omp publishes no marker of its own; FM_OMP_HARNESS=omp is Firstmate's launch marker and the anchored process name omp is its ancestry evidence, as references/harness/omp.md records. ../../../bin/fm-spawn.sh owns worker marker establishment, while the README launch command owns the signed-primary boundary. ../../../bin/fm-harness.sh crew resolves config/crew-harness, where absent or default means firstmate's own harness. ../../../bin/fm-harness.sh secondmate resolves config/secondmate-harness -> config/crew-harness -> firstmate's own harness. ../../../bin/fm-spawn.sh re-resolves on every spawn, and an explicit per-spawn argument wins for that spawn. A new adapter's verified marker and command name must land in ../../../bin/fm-harness.sh.

Operation-to-reference matrix

Every emitted plan appends the selected or recorded harness reference after the named common references. The harness-adapter-routing-v1 object is the machine-readable and human-visible selection contract: choose the operation, choose the scenario within it, then append the selected harness reference. default is the normal scenario when no narrower scenario applies. Kimi establishes its unsupported primary boundary in its selected harness reference; Muse and Gemini follow Non-negotiable safety above. A new tool remains undispatchable until the verify plan, its harness entry, every named owner, and the live checks land.

json
{
  "operations": {
    "start": {
      "default": ["references/common/dispatch.md", "references/common/model-and-effort.md"],
      "trust-dialog": ["references/common/control-and-recovery.md"]
    },
    "trust": {"default": ["references/common/control-and-recovery.md"]},
    "skill": {"default": ["references/common/control-and-recovery.md"]},
    "interrupt": {"default": ["references/common/control-and-recovery.md"]},
    "exit": {"default": ["references/common/control-and-recovery.md"]},
    "resume": {"default": ["references/common/control-and-recovery.md"]},
    "recovery": {
      "default": ["references/common/control-and-recovery.md"],
      "replacement-profile": ["references/common/control-and-recovery.md", "references/common/dispatch.md", "references/common/model-and-effort.md"],
      "secondmate": ["references/common/control-and-recovery.md", "references/common/primary-hooks.md"],
      "replacement-secondmate": ["references/common/control-and-recovery.md", "references/common/dispatch.md", "references/common/model-and-effort.md", "references/common/primary-hooks.md"]
    },
    "primary": {"default": ["references/common/primary-hooks.md"]},
    "model-effort": {
      "default": ["references/common/model-and-effort.md"],
      "configured-profile": ["references/common/model-and-effort.md", "references/common/dispatch.md"]
    },
    "verify": {"default": ["references/common/dispatch.md", "references/common/control-and-recovery.md", "references/common/primary-hooks.md", "references/common/model-and-effort.md"]}
  },
  "harnesses": {
    "claude": "references/harness/claude.md",
    "codex": "references/harness/codex.md",
    "opencode": "references/harness/opencode.md",
    "pi": "references/harness/pi.md",
    "pi-signed": "references/harness/pi.md",
    "grok": "references/harness/grok.md",
    "kimi": "references/harness/kimi.md",
    "cursor": "references/harness/cursor.md",
    "gemini": "references/harness/gemini.md",
    "muse": "references/harness/muse.md",
    "rovo": "references/harness/rovo.md",
    "omp": "references/harness/omp.md",
    "agy": "references/harness/agy.md",
    "devin": "references/harness/devin.md"
  }
}

© kunchenguid, 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 17 other files (references) in .agents/skills/harness-adapters of kunchenguid/firstmate.

  • SKILL.md
  • references/common/control-and-recovery.md
  • references/common/dispatch.md
  • references/common/model-and-effort.md
  • references/common/primary-hooks.md
  • references/harness/agy.md
  • references/harness/claude.md
  • references/harness/codex.md
  • references/harness/cursor.md
  • references/harness/devin.md
  • references/harness/gemini.md
  • references/harness/grok.md
  • references/harness/kimi.md
  • references/harness/muse.md
  • references/harness/omp.md
  • references/harness/opencode.md
  • references/harness/pi.md
  • references/harness/rovo.md

Open the folder on GitHubat commit 19fcbbd

Compare with similar skills

Harness Adapters 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.

Harness Adapters compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harness Adapters this skillkunchenguid/firstmate7.7k—~1.7kAutomated safety check: PassMIT
CCS Task Delegationkaitranntt/ccs2.9k—~1.8kAutomated safety check: PassMIT
Ccmanager Configkbwo/ccmanager1.3k—~1.5kAutomated safety check: PassMIT
Kimi WebbridgeMoonshotAI/kimi-code7.8k—~3.6kAutomated safety check: PassMIT
Open Kimi Pptjinwyp/open-ppt-skill1592 repos~5.1kAutomated safety check: PassMIT
Helmor Bump Vendorsdohooo/helmor1.3k—~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • CCS Task Delegation

    kaitranntt/ccs

    Hands simple, deterministic tasks such as typo fixes, tests and small refactors to cheaper models through the ccs CLI, choosing a profile from your config.

    2.9k GitHub stars~1.8k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Ccmanager Config

    kbwo/ccmanager

    Set up, review, or repair a CCManager config — .ccmanager.json at a git repository root, or the global ~/.config/ccmanager/config.json.

    1.3k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Kimi Webbridge

    MoonshotAI/kimi-code

    Kimi Browser Extension(Kimi 浏览器扩展,原 Kimi WebBridge)lets AI control the user's real browser — navigate, click, type, read, screenshot, and interact with any website using the user's actual login…

    7.8k GitHub stars~3.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Open Kimi Ppt

    jinwyp/open-ppt-skill

    Create, edit, replicate, read, and export presentations. An agent skill from jinwyp/open-ppt-skill.

    159 GitHub starsUsed in 2 repos~5.1k tokens
    Documents & OfficeAuto-check passed
  • Helmor Bump Vendors

    dohooo/helmor

    Bump or upgrade the pinned versions of Helmor's bundled agent CLIs, SDKs, and supporting binaries — Claude Code + claude-agent-sdk (lockstep), Codex, Cursor SDK, OpenCode, Kimi, Pi, and gh / glab /…

    1.3k GitHub stars~2.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Gen Changesets

    MoonshotAI/kimi-code

    A skill your agent uses when generating changesets in the kimi-code repository — deciding whether to write one, which package to list, the bump level, the wording, and the confirmation workflow.

    7.8k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed

More from kunchenguid/firstmate

All 29 skills in this repo
  • Project Management

    kunchenguid/firstmate

    Agent-only procedure for Firstmate project management. An agent skill from kunchenguid/firstmate.

    7.7k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Stow

    kunchenguid/firstmate

    Sweep the current conversation for durable knowledge - user preferences, project facts, operational gotchas, standing decisions, and unfinished next steps - and file each through explicit…

    7.7k GitHub stars~5.1k tokensUpdated today
    Auto-check passed
  • Updatefirstmate

    kunchenguid/firstmate

    Self-update a running firstmate and its secondmates to the latest from origin.

    7.7k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Secondmate Provisioning

    kunchenguid/firstmate

    Agent-only reference for persistent secondmate setup and retirement.

    7.7k GitHub stars~8.1k tokensUpdated today
    Auto-check passed
  • Stow

    kunchenguid/firstmate

    Sweep the current session for uncaptured durable knowledge, file it to disk, persist the open work records this session knows are unfiled or now wrong, and curate the home's tiered, decaying startup…

    7.7k GitHub stars~9k tokensUpdated today
    Auto-check passed
  • Ask User Authority

    kunchenguid/firstmate

    Agent-only decision procedure for ask-user findings. An agent skill from kunchenguid/firstmate.

    7.7k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Questions about Harness Adapters

What does Harness Adapters do?

Agent-only reference for firstmate harness operations. An agent skill from kunchenguid/firstmate. Harness Adapters is an agent skill from kunchenguid/firstmate. Agent-only reference for firstmate harness operations.

How do I install Harness Adapters in Claude Code?

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

How do I install Harness Adapters in Codex?

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

Can I use Harness Adapters 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 kunchenguid/firstmate --skill harness-adapters -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/harness-adapters, .gemini/skills/harness-adapters, .github/skills/harness-adapters and .opencode/skills/harness-adapters in your project.

What does Harness Adapters need to run?

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

Does Harness Adapters 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 Harness Adapters 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 Harness Adapters use?

Harness Adapters 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 Harness Adapters use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Harness Adapters?

Skills that share tags, products or a category with Harness Adapters: CCS Task Delegation (kaitranntt/ccs, 2.9k stars), Ccmanager Config (kbwo/ccmanager, 1.3k stars), Kimi Webbridge (MoonshotAI/kimi-code, 7.8k stars) and Open Kimi Ppt (jinwyp/open-ppt-skill, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harness Adapters?

kunchenguid (a GitHub user) maintains it in kunchenguid/firstmate, which has 7,707 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 8, 2026.

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