iurysza/agent-skills / skills/setup-goal
setup-goal
VerifiedTurns an idea into an approved goal package under ai-artifacts. Use when work needs clarified intent, scope, accepted facts, an implementation plan, and an explicit handoff.
| File | Kind | Size |
|---|---|---|
| PLANNOTATOR.md | markdown | 2.8 KB |
| SKILL.md | skill md | 6.1 KB |
PLANNOTATOR.md
View on GitHub# Optional Plannotator Adapter
Use this adapter only when `plannotator` is already available. It accelerates setup but does not change the canonical goal package.
## Session rule
Plannotator opens a user-driven browser session. Run each command in the foreground and wait until the user submits, dismisses, or explicitly asks to stop. Do not close, kill, refresh, restart, or open another session merely because the command appears idle.
## Intent interview
Use the interview UI when several material decisions remain. Write `interview.json` beside the goal package:
```json
{
"stage": "interview",
"title": "Short human-readable title",
"goalSlug": "<slug>",
"questions": [
{
"id": "scope",
"prompt": "What should be in scope?",
"description": "Why this decision changes the goal.",
"answerMode": "multi-custom",
"recommendedAnswer": "Recommended scope and rationale.",
"recommendedOptionIds": ["ui"],
"options": [
{ "id": "ui", "label": "UI" },
{ "id": "server", "label": "Server" }
],
"required": true
}
]
}
```
Supported answer modes are `text`, `single`, `multi`, `custom`, `single-custom`, and `multi-custom`.
Run:
```bash
plannotator setup-goal interview ai-artifacts/goals/<slug>/interview.json --json > ai-artifacts/goals/<slug>/interview-result.json
```
Read every answer and note. If the user expresses uncertainty, asks a question, or skips a blocking item, address it before writing `intent.md`. Tool JSON is provenance; synthesize the accepted result into `intent.md`.
## Fact review
Write `facts-review.json`:
```json
{
"stage": "facts",
"title": "Short human-readable title",
"goalSlug": "<slug>",
"facts": [
{
"id": "fact-1",
"text": "The proposed fact text.",
"accepted": false,
"removed": false,
"recommendedAutomatedVerification": true,
"automatedVerification": true
}
]
}
```
Run:
```bash
plannotator setup-goal facts ai-artifacts/goals/<slug>/facts-review.json --json > ai-artifacts/goals/<slug>/facts-result.json
```
Apply accepted, edited, and removed facts directly to `facts.md` and `facts.meta.json`. Preserve comments and verification selections. If revising a previous review, carry accepted facts and stable IDs forward rather than recreating them from memory.
## Plan gate
Review the completed plan with:
```bash
plannotator annotate ai-artifacts/goals/<slug>/plan.md --gate
```
If denied, revise from the returned annotations and run the gate again. Plannotator approval satisfies the explicit plan-approval requirement in the core skill.
## Dismissal and fallback
If a session is dismissed, stop that phase and tell the user. Continue through another available question or review tool only when the user asks to proceed without Plannotator.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |