Skip to content
Development
Skill

/goal-clear

Stop and archive the currently active goalkeeper goal. Use when the user invokes /goal-clear to abandon or finalize a goal. Files are moved to .claude/goals/_archive/, never deleted.

From plugin
goalkeeper
138 skills1 hook
Install
$ npx -y skills add bonfire-systems/goalkeeper --skill goal-clear --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/goal-clear

Context preview

The summary Claude sees to decide when to auto-load this skill.

Stop and archive the currently active goalkeeper goal. Use when the user invokes /goal-clear to abandon or finalize a goal. Files are moved to .claude/goals/_archive/, never deleted.

SKILL.md

goal-clear.SKILL.md
name: goal-clear
description: Stop and archive the currently active goalkeeper goal. Use when the user invokes /goal-clear to abandon or finalize a goal. Files are moved to .claude/goals/_archive/, never deleted.

You are operating the **goal-clear** skill. The gk CLI is `python3 "${CLAUDE_PLUGIN_ROOT}/scripts/gk.py"`, abbreviated `gk`.

Flow

1. Run `gk status` to see the active goal and its status. No active goal → tell the user and stop. 2. **Confirm via AskUserQuestion** before archiving (unless the goal is already `done` — then clear is just bookkeeping):

  • **Archive and clear (Recommended)** — proceed.
  • **Cancel** — abort, no changes.

3. Run `gk clear --yes`. gk appends the final log entry, moves the goal directory to `.claude/goals/_archive/<slug>-<timestamp>/`, writes the terminal `active.json`, and — if a chain is in flight — marks it `aborted` without advancing (unreached links' contracts stay in place for re-use). 4. Relay gk's output: the archive path, and that `/goal` or `/goal-prep` starts a new goal.

Hard rules

  • **Never delete files.** gk always archives; nothing is removed.
  • **Never run `gk clear --yes` without the user's confirmation** (except for an already-`done` goal). The `--yes` flag exists so gk knows the question was asked — it is not a license to skip it.
  • **Clearing kills any active chain** — chains are not auto-resumed mid-stream.
Read more
Ships withgoalkeeper

Durable contract-driven goal execution for Claude Code. A subagent judge gates completion against an explicit Definition of Done.

Get the whole plugin
Stats
13
Stars
2
Forks
Active
Maintenance
Python
Language
MIT
License
16d ago
Last commit
4mo ago
Created

Repo: bonfire-systems/goalkeeper

Other skills on goalkeeper.