Agent skill · Security

pi-goal

Persistent Codex-style goal tracking for pi. Use when the user explicitly asks to set, continue, audit, pause, resume, complete, or inspect a long-running goal.

YeonGyu-Kim69,732★ · +488/wk · 2 repos on radarProfile →
claude-codecodexcursorships scriptsNOASSERTION
Install
npx skills add code-yeongyu/oh-my-openagent --skill pi-goal --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 27
SKILL.md size: 1 KB
Bundled scripts: yes
Path: packages/pi-goal/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 67,209 · +483 this week
Language: TypeScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# pi-goal Use goal tools only when the user explicitly wants persistent goal tracking or when an active goal already exists. ## Tools Create a goal: ```ts create_goal({ objective: "Ship the pi-goal extension", token_budget: 50000, }); ``` Inspect a goal: ```ts get_goal({}); ``` Update a goal: ```ts update_goal({ status: "complete", }); ``` `update_goal` only accepts `complete`. User-facing `/goal` commands control pause, resume, budget-limited, and clear transitions. ## Completion Rule Before marking a goal complete, audit the actual current state: 1. Restate the goal as concrete deliverables. 2. Map every explicit requirement to real evidence. 3. Inspect files, command output, test results, or repository state for each item. 4. Treat uncertainty as incomplete. 5. Call `update_goal({ status: "complete" })` only when no required work remains. Use budget-limited status when the reason to stop is budget exhaustion rather than completion.

What's inside
Steps it walks through
  1. Tools
  2. Completion Rule
Ships with 24 files
  • AGENTS.md
  • LICENSE
  • README.md
  • package.json
  • scripts/qa/drive.mjs
  • scripts/qa/mock-provider/index.ts
  • src/goal/command.ts
  • src/goal/continuation.ts
  • src/goal/errors.ts
  • src/goal/format.ts
  • src/goal/prompt.ts
  • src/goal/store.ts
  • src/goal/types.ts
  • src/goal/ui.ts
  • src/goal/validation.ts
  • src/index.ts
  • test/codex-alignment.test.ts
  • test/command.test.ts
  • test/continuation.test.ts
  • test/extension.test.ts
  • test/format.test.ts
  • test/prompt.test.ts
  • test/store.test.ts
  • test/ui.test.ts
first 24 of 27
More from oh-my-openagent
All skills →
About this skill
What does the pi-goal skill do?

Persistent Codex-style goal tracking for pi. Use when the user explicitly asks to set, continue, audit, pause, resume, complete, or inspect a long-running goal.

How do I install it?

Run `npx skills add code-yeongyu/oh-my-openagent --skill pi-goal --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From code-yeongyu/oh-my-openagent, a repository with 67,209 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going