Agent Skills › PrimeIntellect-ai/prime-agent › goal

goal

GitHub

管理持久化线程目标的生命周期，包括查询状态、预算使用情况，创建新目标以及标记目标完成。用于控制长期运行任务的执行与追踪。

packages/coding-agent/skills/goal/SKILL.md PrimeIntellect-ai/prime-agent

Trigger Scenarios

用户明确要求开始一个持久化目标需要检查当前目标的状态或预算消耗目标已完全达成需标记完成

Install

npx skills add PrimeIntellect-ai/prime-agent --skill goal -g -y

More Options

Non-standard path

npx skills add https://github.com/PrimeIntellect-ai/prime-agent/tree/main/packages/coding-agent/skills/goal -g -y

Use without installing

npx skills use PrimeIntellect-ai/prime-agent@goal

指定 Agent (Claude Code)

npx skills add PrimeIntellect-ai/prime-agent --skill goal -a claude-code -g -y

安装 repo 全部 skill

npx skills add PrimeIntellect-ai/prime-agent --all -g -y

预览 repo 内 skill

npx skills add PrimeIntellect-ai/prime-agent --list

SKILL.md

Frontmatter

{
    "name": "goal",
    "description": "Manage the persistent thread goal from the Python REPL. Use to read goal status and budget usage, to start a goal when the user explicitly asks for one, or to mark the active goal complete once its objective is fully achieved."
}

Goal

The thread goal is a persistent objective the harness keeps re-prompting you to pursue across turns until it is complete. Goal state (status, token budget, usage accounting) lives in the host; this skill is the kernel-side interface to it. Call it directly from the Python REPL:

await goal.get()
await goal.create("ship the release notes", token_budget=200000)
await goal.complete()

API

await goal.get() — current goal as a dict: goal (or None when no goal is set), remaining_tokens, and completion_budget_report. The goal dict carries objective, status, token_budget, tokens_used, time_used_seconds, and timestamps.
await goal.create(objective, token_budget=None) — start a new active goal. Fails while a goal is still pending (active, paused, or budget-limited); a completed or errored goal is replaced by the new one. Only create a goal when the user or system/developer instructions explicitly ask for a persistent long-running goal; do not infer goals from ordinary tasks. Set token_budget only when an explicit token budget is requested.
await goal.complete() — mark the existing goal achieved. Use only when the objective has actually been achieved and no required work remains; do not call it merely because the budget is nearly exhausted or because you are stopping work. When the result includes a completion_budget_report, report that final usage to the user.

Rules

Goal status transitions other than completion (pause, resume, clear, budget-limiting) are controlled by the user and the host; there is no API for them here.
When an active goal is actually complete, call await goal.complete(); do not merely say it is done — the harness keeps continuing the goal until the completion call arrives.