harness-loop

harness-loop is a skill for Claude Code from me-cedric/agent-compass. It costs 50 tokens per session (762 once invoked), scanned A, original, MIT.

A repeatable work loop for carrying a large coding goal through planned steps, checks and a saved progress file. It limits the number of turns and resumes from the file after a context change.

In plain words
What is it for?
Use it to deliver multi-file changes, track completed and next steps, run a defined proof command, and stop at completion, a blocker or the turn limit.
Why use it?
It prevents long tasks from losing their place or continuing without a clear way to tell whether they are finished. Each phase has a check, so failures can be found before moving on.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter. Also seen: mentions subagents.

Good fit Use it to deliver multi-file changes, track completed and next steps, run a defined proof command, and stop at completion, a blocker or the turn limit.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/me-cedric/agent-compass/harness-loop
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add me-cedric/agent-compass --skill harness-loop
Clone the repo
git clone --depth 1 https://github.com/me-cedric/agent-compass

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for harness-loop

README.md
[![agentmods](https://agentmods.dev/badge/skills/me-cedric/agent-compass/harness-loop/github.svg)](https://agentmods.dev/skills/me-cedric/agent-compass/harness-loop)
Your own site
<a href="https://agentmods.dev/skills/me-cedric/agent-compass/harness-loop"><img src="https://agentmods.dev/badge/skills/me-cedric/agent-compass/harness-loop/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for harness-loop

Your own site · 80×15
<a href="https://agentmods.dev/skills/me-cedric/agent-compass/harness-loop"><img src="https://agentmods.dev/badge/skills/me-cedric/agent-compass/harness-loop.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 50 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 762 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00050 $0.00762
Opus 5.5 $0.00020 $0.00305
Sonnet 5.5 $0.00010 $0.00152
Haiku 4.5 $0.00005 $0.00076

Measured 10d ago against content hash 5db08e561fa8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

harness-loop scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/harness-loop/SKILL.md · 64 lines

How it starts

The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.

harness-loop

Set up

State these items before you start. Ask only about an item that blocks safe work.

  1. Goal: one sentence.
  2. Check: one command that proves the goal.
  3. Stop condition: the check passes, the turn cap is reached, or a blocker stops the work.
  4. Turn cap: 20 turns unless the user says another number. Never raise the cap yourself.
  5. Out of scope: what you will not touch.

Write the progress file .agents/progress/<goal-slug>.md. It holds the five items above, the done list, the next step and the blockers. Read it at the start of each turn. A new context resumes from this file.

Loop

  1. Read the repository rules, the project memory and the specs that the goal touches.
  2. For work on more than one file, run the deliver workflow (.claude/workflows/deliver.js) with the goal as args. The workflow plans, then splits the work into 2 file groups at most. Workers build. A reviewer checks in a fresh context. Fixes take 2 rounds at most. Without workflow support, do the same steps with the scout, worker and reviewer agents.
  3. Do one phase in each turn.
  4. After each phase, read your diff and run the check.
  5. Fix a failure that you introduced before you start the next phase.
  6. Write the result in the progress file.
  7. At the cap, report "partial" with the blocker. Do not continue.

Parallel work

  1. Run 2 workers at most. Give them files that do not overlap.
  2. Before the first edit in a worktree or a new branch, run git log --oneline main..HEAD and git log --oneline HEAD..main.
  3. If the branch is behind and has no commits of its own, run git merge --ff-only main.
  4. If the branch is behind and has its own commits, tell the parent. Do not rebase.
  5. If the user allows commits, commit each finished piece. A session that dies loses uncommitted work.
  6. Stay inside the files that your task names.
  7. Do not remove a worktree because it looks finished. Wait for the signal of the orchestrator.

Worktree fence

The desktop app fences each subagent. A hook refuses Edit, Write and git commands that target another worktree.

Read the full file on GitHub · 64 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 64 lines · 50 tokens per session scan A 5db08e561fa8

Subscribe to this mod's changes

harness-loop is a skill published in the GitHub repository me-cedric/agent-compass (3 stars, last pushed 4d ago), licensed MIT. It adds 50 tokens to every session and 762 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-18.

Related

Other skills, from other repositories

agentmail

Use your assigned AgentMail inbox to read email tasks, explicitly send or reply, and check delivery. Provided automatically by your inbox assignment.

paperclipai/paperclip · 30 tokens

founder-coach

Personal leadership development for founders and first-time CEOs. Covers founder archetype identification, delegation frameworks, energy management, CEO calendar audits, leadership style evolution, blind spot identification, imposter syndrome, founder mental health, and succession planning. Use when a founder feels…

alirezarezvani/claude-skills · 101 tokens

computer-use

Read and drive native desktop apps through the accessibility layer — list apps, snapshot a window as a numbered element tree, then click/type/scroll/drag by element index or screen coordinates. Use for a desktop app, not a web page. macOS + Windows; off unless enabled in Settings.

kirodotdev/KiroCrew · 62 tokens

meetings

Context for the Meetings app's data — where a meeting's notes, diagram, transcript-derived tasks and calendar cache live, what the lifecycle states mean, how the app's agents are driven. Load when asked about a meeting's notes or action items, or when touching the meetings app data dir.

kirodotdev/KiroCrew · 62 tokens

mochi-remind

Handle due reminders — notify the user with natural language and mark them done.

kirodotdev/KiroCrew · 20 tokens

subscription-setup

A setup workflow for creating recurring medical-learning subscriptions after a doctor’s profile has been registered.

TencentCloud/Octop · 80 tokens