ba-user-story-spec

Aggregate UI specs, sequence diagrams, and activity diagrams into 7-section Markdown user stories.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Yukine5377/common --skill ba-user-story-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ba-user-story-spec
Source: https://github.com/Yukine5377/common/tree/main/.cursor/skills/ba-user-story-spec
Command: npx skills add https://github.com/Yukine5377/common --skill ba-user-story-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, requests, markdown, and includes scripts (resource) components.

What problem does it solve?

Teams often struggle to synthesize complete User Story/Use Case documentation from scattered UI specs, sequence diagrams, and activity diagrams. This Skill automates the collection and integration of data from UI Spec, Sequence Diagram, and Activity Diagram, enforces a standard structure, and stores the resulting Markdown file in the designated folder for easy sharing and further processing.

Core Features & Use Cases

  • Aggregate data from UI Spec, Sequence Diagram, and Activity Diagram to produce a complete User Story/Use Case document.
  • Auto-check and fetch missing information from related skills when needed, reducing manual follow-ups.
  • Save the generated Markdown to a specified User Story folder; ready for optional DOCX export or Confluence publishing.
  • Use Case example: Given an Epic and a function, automatically assemble 7-section documentation including UI details, API spec, and workflow diagrams.

Quick Start

Gather information from UI Spec, Sequence Diagram, and Activity Diagram, then generate and save the full User Story/UC document in the specified folder.

Frequently Asked Questions about ba-user-story-spec

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

FAQPage Schema
How do I automate user story documentation assembly from multiple UI specs and diagrams?▼

Automate user story documentation by aggregating data from UI specs, sequence diagrams, and activity diagrams into a standardized 7-section Markdown file. The workflow auto-checks and fetches missing information from related skills, saving the complete document to a designated folder for immediate sharing.

What is the best way to generate use case documents that include API specs and workflow diagrams?▼

Generate use case documents by providing an Epic and a function to automatically assemble a 7-section Markdown file. This process integrates UI details, API specs, and workflow diagrams, ensuring comprehensive documentation is compiled and stored in the specified User Story folder.

Can I export Markdown use case documentation to DOCX or publish it to Confluence?▼

Yes, you can export the generated Markdown use case documentation to DOCX format or publish it directly to Confluence. The Skill uses python-docx and markdown dependencies to convert and export the assembled 7-section document after saving it to the designated folder.

Does this user story generation tool automatically fill in missing sequence or activity diagram data?▼

Yes, the user story generation tool automatically checks for missing information and fetches it by coordinating with related skills. This reduces manual follow-ups when data from UI specs, sequence diagrams, or activity diagrams is incomplete during the aggregation process.

How do I structure use case documentation to cover UI specifications and sequence diagrams together?▼

Structure use case documentation using a standardized 7-section Markdown format that aggregates UI specifications, sequence diagrams, and activity diagrams. This enforces a consistent structure across the team, synthesizing scattered data into a single comprehensive User Story document.

What limitations exist when aggregating activity diagrams and UI specs into a single Markdown file?▼

The aggregation requires existing UI specs, sequence diagrams, and activity diagrams to fetch missing data from related skills. If related skills cannot provide the missing information, the 7-section Markdown output may remain incomplete, requiring manual data entry before DOCX export.