refine

v2026.09.24

Sharpen todo items in brain/todos.md into precise, actionable prompts via targeted questioning. Triggers: "refine", "refine todos", "clarify todos".

GitHub
Install command
npx skhub add poteto/refine
Markdown
SKILL.md

Refine

Read brain/todos.md and refine unclear items into actionable prompts through targeted questioning.

Workflow

Use Tasks to track progress. Create a task for each step below (TaskCreate), mark each in_progress when starting and completed when done (TaskUpdate). Check TaskList after each step.

  1. Read brain/todos.md and review items under ## Open.
  2. Triage each item: is it clear enough to act on without further context? A clear item specifies what is wrong, where it happens, and what the fix should be. Skip items that already meet this bar.
  3. Ask clarifying questions about unclear items using AskUserQuestion. Group related questions — aim for one round of questions, not a back-and-forth (to minimize back-and-forth and user fatigue). Good clarifying questions target:
    • What — what exactly is the problem or desired behavior?
    • Where — which part of the app, which component, which flow?
    • How — how should it work instead? What does "fixed" look like?
  4. Rewrite unclear items in-place using Edit, incorporating the user's answers. Each rewritten item should be a self-contained prompt that another agent could act on without additional context.
  5. Remove any items the user says are already done or no longer relevant.
  6. Report a summary of what changed.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

.agents/skills/refine

Default branch

main

Latest commit

82d2921

Tree SHA

9fccb6b