mcpField
G
goal-loop

goal-loop

github.com/darknesskillerAgent workflows0101 installsUpdated 4w ago
Repository

About goal-loop

A goal-oriented agent skill that guides work through small actions, focused verification, and repeated critique. It defines completion criteria from the goal and repository context, limits rounds, and pauses before consequential operations.

Key features

  1. 01Infer completion criteria
  2. 02Choose the smallest useful action
  3. 03Verify each state-changing action
  4. 04Review remaining work each round
  5. 05Limit rounds with a default of five
  6. 06Pause before consequential operations

Use cases

  1. 01Completing repository tasks in defined rounds
  2. 02Checking changes with targeted tests or diffs
  3. 03Tracking blockers that prevent safe progress
  4. 04Stopping before commits, deployment, or irreversible actions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/darknesskiller/skills --skill goal-loop

After installing, type/goal-loopin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Goal Loop

Steps

  1. Parse goal. Read max_rounds (default 5). Reject non-positive integer.
  2. Infer completion criteria from goal and repo context. Record uncertainty as blocker only when it prevents safe next action.
  3. Choose smallest useful next action. Route through existing skill when one fits.
  4. Verify with narrowest useful check: test, diff, command output, artifact.
  5. Critique: what proves or disproves completion? What remains? Smallest next action?
  6. Criteria evidenced: stop completed. max_rounds reached: stop max_rounds. Else repeat from 3.

Rules

A round = one state-changing action + verification. Tool calls are not rounds. Do not spend rounds restating goal, polling without change, or speculative cleanup. Pause before commits, pushes, PR, deploy, production, credentials, irreversible ops.

Status

End with exactly one: completed, blocked (name unblocker), max_rounds (name remaining criteria).

Comments

Markdown supported