goal

Persist session goals in SQLite with pause, resume, and completion controls.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill goal-tumeloramaphosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goal
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/goal
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill goal-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It solves the problem of losing track of a persistent objective during long or multi-step work, especially when you need safe pause/resume behavior rather than one-off answers.

Core Features & Use Cases

  • Persistent per-session goals: Saves an active, paused, budget-limited, or complete goal in a local SQLite database so your Claude session can continue later.
  • Codex-style command surface: Lets you set, view, pause, resume, clear, or complete a goal using a single consistent interface.
  • Completion audit guardrail: Prevents marking completion until the skill prompts for deliverables and checks evidence from the repo/files/commands.
  • Soft token budget handling: Supports an optional soft token budget mode and adjusts continuation behavior when exhausted.
  • Stop-hook continuation control: Blocks stopping while a goal is active and limits runaway auto-continuations, requiring pause/resume/clear/complete for control.

Quick Start

Tell your AI to run your objective by writing: /goal "Ship the first version of the mission-control UI and add a completion audit gate."

Frequently Asked Questions about goal

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

FAQPage Schema
How do I maintain a persistent objective across multiple turns in Claude Code?

You can maintain a persistent objective by storing it in a local SQLite database, which saves the active, paused, or complete state so your session can safely resume long-running tasks later.

How do I prevent my AI agent from prematurely stopping a long-running software task?

To prevent premature stopping, you can use a stop-hook control mechanism that blocks the session from halting while a goal is active, enforcing a max-continue limit to manage runaway auto-continuations.

How does a completion audit gate validate software task success?

A completion audit gate validates success by prompting for deliverables and checking real evidence from repository files or executed commands before allowing a persistent objective to be marked complete.

Can I pause and resume long-running research goals without losing session state?

Yes, you can pause and resume long-running research goals without losing state by leveraging SQLite state persistence that explicitly saves the active, paused, budget-limited, or complete status locally.

What is the best way to enforce a soft token budget during iterative task automation?

The best way to enforce a soft token budget during iterative automation is using a mode that adjusts continuation behavior when the budget is exhausted, preventing runaway processes while maintaining the active goal.

Does goal management with Codex-style commands work for iterative software tasks?

Yes, goal management with Codex-style commands works for iterative software tasks by providing a consistent interface to set, view, pause, resume, clear, or complete objectives across multiple working turns.