Agent Harness Builder
Builds and audits harnesses that keep coding agents reliable across sessions.
Install
npx skills add walkinglabs/learn-harness-engineering --skill harness-creator -g -a claude-code -y- Repository
- walkinglabs/learn-harness-engineering22.8k
- Category
- AI and agents
- Updated
- 13d ago
- License
- MIT
- Context cost
- Lightabout 1,117 tokens
- Runs scripts
- Yes, review before use
What it does
Build, audit, and improve harnesses that make AI coding agents reliable: AGENTS.md/CLAUDE.md instruction files, feature/state tracking, verification gates, scope boundaries, session handoff, memory persistence, context budgets, tool-permission safety, and multi-agent coordination. Use this whenever a coding agent is unreliable across sessions, forgets context, drifts out of scope, claims "done" before tests pass, or starts each session inconsistently, or when creating or assessing AGENTS.md, CLAUDE.md, feature_list.json, init.sh, progress.md, or session-handoff files. Reach for it even if the user never says the word "harness.
Harness Creator
Use this skill to make a repository easier for coding agents to start, stay in scope, verify work, and resume across sessions. Keep the harness small enough that agents actually follow it.
Not for model selection, prompt tuning in isolation, chat UI design, or general app architecture.
Core Model
Every useful coding-agent harness has five subsystems:
| Subsystem | Minimal artifact | Purpose |
|---|---|---|
| Instructions | AGENTS.md or CLAUDE.md | Startup path, working rules, definition of done |
| State | feature_list.json, progress.md | Current feature, status, evidence, next step |
| Verification | init.sh or documented commands | Tests/checks the agent must run before claiming done |
| Scope | Feature dependencies and done criteria | Prevents overreach and half-finished work |
| Lifecycle | session-handoff.md, end-of-session routine | Makes the next session restartable |
First Move
- Inspect what already exists: instruction files, feature/state files, verification commands, docs, package manifests.
- Ask only for missing context that cannot be inferred safely: target agent, desired file name, tolerance for structure, and whether overwriting is allowed.
- Prefer a minimal harness first. Add memory, tool safety, multi-agent, or benchmark details only when the user's problem calls for them.
Common Tasks
Create a harness
Use the bundled script when working on a local repository:
node skills/harness-creator/scripts/create-harness.mjs --target /path/to/project
Options:
--agent-file CLAUDE.mdfor Claude-oriented projects.--package-manager npm|pnpm|yarn|bunwhen detection is wrong.--commands "cmd one,cmd two"for custom verification.--forceonly after confirming overwrites are acceptable.
Then explain what was created and how the user should replace placeholder feature entries.
Audit an existing harness
Run:
