refine

Convert Refinement notes into testable TODO requirements with IDs.

2|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/aleksandrov/instructions --skill refine-aleksandrov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/aleksandrov/instructions/tree/main/.claude/skills/refine
Command: npx skills add https://github.com/aleksandrov/instructions --skill refine-aleksandrov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refinement ideas often remain vague and untracked, making it hard to translate them into actionable work and measurable outcomes.

Core Features & Use Cases

  • Analyze the Refinement section of TODO.md and extract clear, testable requirements.
  • Generate structured TODO entries with consistent IDs and acceptance criteria.
  • Update the TODO.md by moving validated items into the main TODO section and clearing the Refinement section.

Quick Start

Ask the Refinement subsystem to convert your Refinement notes into concrete requirements.

Frequently Asked Questions about refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert refinement ideas into structured requirements?

To convert refinement ideas into structured requirements, the Skill reads your Refinement notes and generates testable TODO entries with consistent IDs and acceptance criteria. It moves validated items into the main TODO section and clears the Refinement section.

What is the best way to track vague product planning ideas in a TODO file?

Tracking vague product planning ideas involves extracting clear, testable requirements from your notes and generating structured TODO entries. This Skill analyzes the Refinement section of your TODO.md, creates entries with consistent IDs and acceptance criteria, and updates the file automatically.

Can I automatically generate acceptance criteria from raw refinement notes?

Yes, you can automatically generate acceptance criteria from raw refinement notes. The Skill analyzes your Refinement section and creates structured TODO entries equipped with testable acceptance criteria and consistent tracking IDs.

Does this refinement workflow require an empty Refinement section in TODO.md?

This refinement workflow applies to product planning tasks where TODO.md contains an empty Refinement section or needs structured requirements generated from Refinement notes. It reads the notes, updates TODO, and clears the Refinement section upon completion.

Why do my refinement notes remain untracked in my product management workflow?

Refinement notes remain untracked because they often stay vague and lack structured formatting. This Skill solves the problem by translating raw ideas into actionable, testable TODO requirements with measurable outcomes and consistent IDs.