What is a 'branch story' in this context?

A branch story is a comprehensive Markdown document that serves as the PR description, detailing the intent, implementation journey, and impact of a code change based on commit history.

Can it identify risks before a release?

Yes, it features a release-readiness agent that provides a verdict on whether changes are safe for production, along with specific pre- and post-release instructions.

Where are the generated narratives stored?

Narratives are stored as Markdown files within the .workaholic/stories/ directory and are indexed in a centralized README for easy navigation.

How does the skill handle implementation visualization?

The skill automatically generates Mermaid.js flowcharts that map out subagent architectures, safety rules, and command changes to visualize the development progression.

Does it track developer performance?

Yes, it includes a performance-analyst agent that calculates commit velocity, duration, and provides a qualitative review of development consistency and agility.

Automated PR Narrative Generator

Name: Automated PR Narrative Generator
Author: qmu

byqmu

0•

Collaboration Tools

Generates comprehensive, data-driven branch narratives and pull request descriptions using multi-agent analysis and performance metrics.

The write-story skill automates the creation of 'branch stories'—highly structured Markdown documents that serve as the definitive source of truth for Pull Request content. By orchestrating a suite of specialized agents including overview writers, performance analysts, and release reviewers, it synthesizes commit history into a cohesive narrative. This skill is essential for teams looking to standardize documentation, providing everything from Mermaid-based implementation flowcharts and chronological ticket summaries to detailed velocity analysis and release-readiness verdicts.

Key Features

01Automated release-readiness auditing with pre/post-release instructions

02Multi-agent content orchestration for automated section population

03Chronological ticket synthesis with automated GitHub commit linking

04Deep performance analysis including velocity metrics and decision reviews

05Dynamic Mermaid flowchart generation for visual implementation journeys

060 GitHub stars

Use Cases

01Generating historical technical documentation for complex feature development

02Standardizing high-quality Pull Request descriptions across engineering teams

03Automating impact analysis and velocity tracking for project stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add qmu/workaholic write-story

For use in Claude.ai and ChatGPT

Download Skill