Refine

SkillProductivity

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

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Refine skill

What this skill tells your AI

The instructions your AI receives, as published by poteto/noodle in .agents/skills/refine/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
270
Forks
15
Last commit
Mar 2026
Advanced
Catalog kind
skill
Gateway key
refine-poteto
Source
github.com/poteto/noodle