Agent skill · Workflow & Productivity

plannotator-setup-goal

Turn an idea or objective into a goal package for /goal. Interviews the user, builds a reviewed fact sheet via Plannotator, then explores the codebase to produce an execution plan.

Michael Ramos7,402★ · +233/wk · 1 repos on radarProfile →
claude-codecodexships scriptsApache-2.0
Install
npx skills add backnotprop/plannotator --skill plannotator-setup-goal --agent claude-code

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

Facts
Files in the skill folder: 3
SKILL.md size: 9 KB
Bundled scripts: yes
Path: apps/skills/extra/plannotator-setup-goal/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 7,510 · +108 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

# Setup Goal Turn an idea into a goal package at `goals/<slug>/` through structured discovery, user interview, and codebase exploration. ## Phases ### 1. Rearticulate State back what the user wants in your own words. If the conversation already has rich context, summarize it. If the goal is bare or vague, do minimal shallow exploration of the codebase to ground your understanding. Keep it to 2-3 sentences. Wait for the user to confirm or correct before continuing. Create the goal directory once the slug is clear: ```bash mkdir -p goals/<slug> ``` Use `goals/<slug>/` for both working JSON files and final docs. The JSON files are provenance and iteration state; the markdown files are the human-readable authoritative goal package. **Browser session patience rule:** Plannotator goal setup is a user-driven browser session. After launching an interview or facts command, be absolutely patient and keep waiting on the user until they submit, dismiss, or explicitly ask you to stop. Do not close, kill, restart, refresh, or open a second copy just because the UI is idle or the user is taking time. Never close and reopen the session as a way to update state; if a rerun is needed after the prior

What's inside
Steps it walks through
  1. Phases
  2. 1. Rearticulate
  3. 2. Interview Bundle
  4. 3. Fact Sheet
  5. 4. Plan
  6. 5. Goal Output
Ships with 2 files
  • SKILL.test.ts
  • agents/openai.yaml
Commands it runs
mkdir -p goals/<slug>
plannotator setup-goal interview goals/<slug>/interview.json --json
plannotator setup-goal interview goals/<slug>/interview.json --json | tee goals/<slug>/interview-result.json
plannotator setup-goal facts goals/<slug>/facts-review.json --json
plannotator setup-goal facts goals/<slug>/facts-review.json --json | tee goals/<slug>/facts-result.json
plannotator annotate goals/<slug>/plan.md --gate
More from plannotator
All skills →
About this skill
What does the plannotator-setup-goal skill do?

Turn an idea or objective into a goal package for /goal. Interviews the user, builds a reviewed fact sheet via Plannotator, then explores the codebase to produce an execution plan.

How do I install it?

Run `npx skills add backnotprop/plannotator --skill plannotator-setup-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 backnotprop/plannotator, a repository with 7,510 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