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.