Plannotator Setup Goal

This is a structured interview system that turns vague project ideas into documented goal packages. Instead of letting you wander through planning, it gates progress with user confirmation at each step: first it rearticulates your ask, then runs either a deep one-question-at-a-time grill session or a compact multi-question interview bundle, then produces a fact sheet you review in the browser before any code gets written. The workflow is deliberately patient, waiting on browser sessions instead of moving ahead when you're thinking. It's opinionated about not asking questions the codebase can answer and about making facts testable rather than fluffy. Use this when you need to hand Claude a solid spec instead of hoping vibes and iteration will get you there.

skills.sh installs: 12.5K
GitHub stars: 10K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add backnotprop/plannotator --skill plannotator-setup-goal --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

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.

SKILL.md on GitHub