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

goal

GitHub

管理持久化线程目标，支持查询状态与预算、创建新目标及标记完成。用于在用户明确要求时启动长期任务并跟踪进度。

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

Trigger Scenarios

用户明确要求创建或管理一个持久化的长期目标需要查看当前目标的执行状态、剩余token预算或使用报告

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")
# Only pass token_budget when the user explicitly asks for one:
# 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.