usm-refine

Refine YAML-based user story maps into reviewable artifacts.

2|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/boykush/livt --skill usm-refine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usm-refine
Source: https://github.com/boykush/livt/tree/main/plugins/discovery-facilitator/skills/usm-refine
Command: npx skills add https://github.com/boykush/livt --skill usm-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill refines raw User Story Mapping baselines, improving narrative flow, granularity, and story framing, ensuring they are ready for review and implementation.

Core Features & Use Cases

  • Refine Narrative Flow: Sharpen activity/step names for a coherent user journey.
  • Improve Granularity: Adjust tasks for consistent backbone level.
  • Enhance Story Framing: Phrase stories for user value, maintaining intent.
  • Order Correction: Fix narrative order or priority if necessary.
  • Consult Expert: Utilize usm-expert skill for judgment on complex decisions.

Quick Start

Use the usm-refine skill to refine the 'user-story-map.yaml' and generate a reviewable PR diff.

Frequently Asked Questions about usm-refine

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

FAQPage Schema
How do I refine a user story map for better narrative flow and structure?

To refine a user story map, you analyze and modify YAML-based story maps to sharpen activity and step names, adjust task granularity for a consistent backbone, and correct narrative order or priority. This ensures a coherent user journey ready for review and implementation.

What is the best way to format user stories for user value in collaborative software development?

Formatting user stories for user value involves phrasing tasks to highlight user intent and value while maintaining the original goal. Refining story maps adjusts the framing of stories within the YAML structure to ensure they are ready for collaborative review and implementation.

Can I use a YAML file to refine user story mapping baselines into reviewable artifacts?

Yes, you can refine YAML-based user story mapping baselines into reviewable artifacts. The process analyzes the YAML file to improve narrative flow, granularity, and story framing, generating a PR diff for team review in collaborative software development.

How do I fix inconsistent task granularity in a user story map backbone?

Fixing inconsistent task granularity requires analyzing the story map YAML and adjusting tasks to maintain a consistent backbone level. Refinement improves the structure by aligning tasks uniformly, ensuring the narrative flow is coherent for implementation.

Do I need an expert system to handle complex decisions during story map refinement?

Yes, for complex decisions during story map refinement, an external expert system is leveraged. The refinement process consults an expert to provide judgment on difficult structural or narrative choices, ensuring the user story map baseline is accurately improved.

When should I not use automated story map refinement?

You should avoid automated story map refinement if your baseline is not stored in a YAML format or if your collaborative software development process lacks a review mechanism for PR diffs. The refinement process relies on YAML analysis and external expert consultation for structural modifications.