| name | agent-goal |
| description | Create a slash-command `/goal` for long-running Codex or Claude Code work when the user explicitly asks for a `/goal`, agent goal, or completion condition. Outputs one goal line with the objective, starting context, validation evidence, and stop condition. |
Agent Goal
Write one /goal line that a coding agent can keep pursuing until the transcript proves the work is done.
This skill owns the slash-goal artifact. Do not use it for ordinary prompt
drafting, handoffs, continuation prompts, delegation briefs, or prompt
engineering.
Shape
/goal <single objective> in <lane> until <observable evidence proves completion>. First read <starting context>. Work in checkpoints and surface <validation evidence> after each checkpoint.
Answer these in order, then compress them into one line:
What should change?
Where should the agent start?
What evidence proves it changed?
When should the agent stop?
Include only execution-critical detail:
- Objective: one concrete outcome, not a backlog of unrelated wishes.
- Lane: files, packages, apps, issues, specs, or the intended work area.
- Starting context: the first files, plans, logs, screenshots, or acceptance criteria to read.
- Evidence: command output, tests, build result, screenshot check, eval score, file count, or reviewed artifact.
- Stop condition: the exact transcript-visible state that means the goal is achieved.
Rules
- Start the answer with
/goal when the user asks for the goal text.
- Make completion judgeable by someone who can only read the transcript.
- Prefer exact checks over vague proof: "
bun test packages/auth exits 0" beats "tests pass."
- Point long requirements at a file instead of pasting them into the goal.
- Ask for checkpoints when the work spans multiple turns.
- Bound repeated failure: after three failed attempts on the same check, report the root cause and next decision.
- Do not create a
/goal for vague wishes, open-ended research, unrelated chores, or work with no observable evidence.
Platform Note
Different agents may evaluate goals differently, but the portable rule is the
same: the goal should not rely on hidden state. Tell the agent to run checks and
surface evidence in the transcript.
Check
Before handing back a goal, verify:
- It has one main objective.
- It names where to start.
- It names the evidence that proves completion.
- It tells the agent to surface that evidence.
- It tells the agent when to stop.
