Name: bmAD-technical-story-refiner
Author: xvweirong

Imported from xvweirong/BMAD (.kilocode/skills/bmAD/technical-story-refiner/SKILL.md). Install upstream with npx skills add xvweirong/BMAD --skill technical-story-refiner. Copyright stays with the author.

Technical Story Refiner Skill

This skill guides the detailed technical refinement of individual stories following the BMAD methodology.

When to Use This Skill

User has a backlog of approved stories
Stories need detailed technical design
Implementation steps need to be defined
Technical dependencies need to be clarified

When NOT to Use This Skill

User needs to create the initial story backlog (use Product Owner mode)
User wants to implement stories directly (use Story Developer mode)
User only has high-level requirements without stories
User needs architecture design (use Software Architect mode)

Workflow

Step 1: Read Source Documents

Use read_file tool to extract content from:

project_requirements.md - Functional specifications
project_architecture.md - Technical architecture
project_stories.md - Story backlog

Step 2: Select Story for Refinement

Identify the next story to refine based on:

Priority
Dependencies
Sprint assignment

Step 3: Define User Story Format

Ensure story follows standard format:

As a [role]
I want [action]
so that [benefit]

Step 4: Provide Context and Background

Document:

Business context and drivers
Current pain points or limitations
Expected improvements
Impact on users or business

Step 5: Define Technical Design

For each story, specify:

Data Model - Objects, fields, relationships
API Design - Endpoints, contracts
Business Logic - Rules and validations
UI/UX - Interface requirements
Error Handling - Edge cases

Step 6: Set Estimation and Criteria

Define:

Story points
Sprint assignment
Priority
Dependencies (prerequisites, blocking, blocked by)
Module/Component
Complexity (Low/Medium/High)
Acceptance criteria (numbered, testable)

Step 7: Generate Story Document

Create individual story_N.md files using the template in assets/story-N-template.md.

Output

The deliverables are story_N.md files - detailed technical specifications for each story.

Templates

assets/story-N-template.md - Document template for detailed story

References

BMAD workflow: Phase 5 of 8-stage Agile development

Install bmAD-technical-story-refiner and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xvweirong-bmad-technical-story-refiner", "kind": "skill", "name": "bmAD-technical-story-refiner", "description": "Guide for transforming user stories into actionable, technically detailed specifications ready for implementation. This skill should be used when stories need detailed technical design before development begins.", "publisher": "xvweirong", "version": "1.0.0", "capabilities": { "domains": [ "creative" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Guide for transforming user stories into actionable, technically detailed specifications ready for implementation. This skill should be used when stories need detailed technical design before development begins." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/xvweirong/BMAD", "path": ".kilocode/skills/bmAD/technical-story-refiner/SKILL.md", "ref": "ca3debdd7388d6608ed032d2e9df292e6878b413", "url": "https://github.com/xvweirong/BMAD/blob/ca3debdd7388d6608ed032d2e9df292e6878b413/.kilocode/skills/bmAD/technical-story-refiner/SKILL.md", "key": "xvweirong/BMAD/.kilocode/skills/bmAD/technical-story-refiner/SKILL.md" } }, "instructions": "# Technical Story Refiner Skill\n\nThis skill guides the detailed technical refinement of individual stories following the BMAD methodology.\n\n## When to Use This Skill\n\n- User has a backlog of approved stories\n- Stories need detailed technical design\n- Implementation steps need to be defined\n- Technical dependencies need to be clarified\n\n## When NOT to Use This Skill\n\n- User needs to create the initial story backlog (use Product Owner mode)\n- User wants to implement stories directly (use Story Developer mode)\n- User only has high-level requirements without stories\n- User needs architecture desig", "cost": { "context_tokens": 552 } }

bmAD-technical-story-refiner

About