refine-story

Refine user stories by adding acceptance criteria and technical analysis.

6|Updated Aug 3, 2025
One-click install
npx skills add https://github.com/foomakers/pair --skill refine-story-foomakers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-story
Source: https://github.com/foomakers/pair/tree/main/packages/knowledge-hub/dataset/.skills/process/refine-story
Command: npx skills add https://github.com/foomakers/pair --skill refine-story-foomakers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of refining user stories, ensuring they are clear, detailed, and ready for development by moving them from a 'Todo' to a 'Refined' state.

Core Features & Use Cases

  • Structured Refinement: Guides the user through essential stages: requirements analysis (Given-When-Then), technical assessment, and sprint readiness.
  • Idempotency: Detects partial progress and resumes refinement from the last completed section, preventing redundant work.
  • PM Tool Integration: Composes and updates story issues in project management tools via the /write-issue skill.
  • Use Case: A product manager needs to prepare a new feature request for the development team. This Skill takes the initial story idea, prompts for necessary details like acceptance criteria and technical considerations, and formats it into a development-ready story.

Quick Start

Use the refine-story skill to refine the highest priority story in the backlog.

Frequently Asked Questions about refine-story

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

FAQPage Schema
How do I add acceptance criteria and technical analysis to user stories?

Refining user stories involves systematically adding Given-When-Then acceptance criteria, performing technical assessment, and appending sprint readiness details to move them from a Todo to a Refined state for agile development.

What is the best way to prepare user stories for sprint readiness?

Sprint readiness for user stories is achieved through structured refinement stages, which orchestrate requirements gathering, technical assessment, and estimation to ensure the story is clear and detailed for the development team.

Can I resume user story refinement if the process is interrupted?

Yes, the story refinement process supports idempotency by detecting partial progress and resuming from the last completed section, which prevents redundant work and ensures no data is lost during interruptions.

Does this story refinement workflow integrate with project management tools?

Yes, the workflow integrates with project management tools by composing and updating story issues directly, ensuring that the acceptance criteria and technical analysis are synced with your existing agile tracking system.

What steps are needed to move a backlog story to a Refined state?

Moving a backlog story to a Refined state requires guiding it through structured stages of requirements analysis, technical assessment, and sprint readiness formatting to transform the initial idea into a development-ready task.

Are there limitations when refining stories with partial details?

There are no strict limitations for partial details because the refinement workflow detects existing progress and resumes from the last completed section, allowing you to incrementally build the story without redundant work.