goal

Manages a durable build objective with budget and turn ceilings via a repo-root sentinel file.

4|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Arete-Consortium/ai-skills --skill goal-arete-consortium
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: goal
Source: https://github.com/Arete-Consortium/ai-skills/tree/main/workflows/goal
Command: npx skills add https://github.com/Arete-Consortium/ai-skills --skill goal-arete-consortium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long autonomous coding sessions can drift from the original objective and silently burn through budget. This Skill gives you a persistent control surface to set, monitor, pause, and clear a build goal with explicit spending and turn limits enforced by hooks. ## Core Features & Use Cases - Goal Lifecycle Control: Set, inspect, pause, resume, extend, or clear a build objective stored in a .goal-active sentinel at the repo root. - Budget Enforcement: Track spent_usd against a budget_ceiling_usd and turns against a turn_ceiling, forcing a checkpoint when either ceiling is hit. - Hook Integration: Drives the goal-loop (UserPromptSubmit) and goal-gate (PreToolUse) hooks that inject the objective each turn and gate destructive operations. - Use Case: You want Claude to autonomously refactor a module but stop after $10 or 25 turns. Run /goal "refactor auth module to use JWT" and the loop enforces the checkpoint discipline until you run /goal extend or /goal clear. ## Quick Start Ask Claude to set a build goal by saying: use /goal to engage a build objective of refactoring the auth module with a $10 budget ceiling.

Frequently Asked Questions about goal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set a budget limit for an autonomous Claude coding session?▼

Run /goal followed by your objective in quotes, for example /goal "refactor the auth module". This writes a .goal-active sentinel at the repo root with a default budget_ceiling_usd of 10 and turn_ceiling of 25, and the hooks enforce a checkpoint at either limit.

How do I pause and resume a build goal without losing state?▼

Use /goal pause to set the sentinel mode to paused, which makes the loop inert while preserving all state. Use /goal resume to set the mode back to engaged and continue where you left off.

Does the goal command work outside a git repository?▼

No. The skill operates on the sentinel at $(git rev-parse --show-toplevel)/.goal-active, so it requires a git repository. If you are not inside one, it will tell you the goal-loop requires a git repo.

What happens when the turn or budget ceiling is reached?▼

The goal-loop hook forces a checkpoint where autonomous progress stops and you must review ROI before continuing. Only /goal extend re-authorizes another budget window, raising the turn ceiling by a default of 15 and resetting the turn counter.

How do I log actual API spending against my goal budget?▼

Use /goal spend followed by the dollar amount observed from your statusline, for example /goal spend 3.50. This updates the spent_usd field, which is honored against the budget_ceiling_usd during the loop.