branch-uml-diagrams

Generate before/after PlantUML diagrams for changed spec files on a feature branch.

3|1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/sirius-cc-wu/sirius-skills --skill branch-uml-diagrams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-uml-diagrams
Source: https://github.com/sirius-cc-wu/sirius-skills/tree/main/branch-uml-diagrams
Command: npx skills add https://github.com/sirius-cc-wu/sirius-skills --skill branch-uml-diagrams

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams visualize code changes on a feature branch by generating before/after PlantUML diagrams for relevant spec files, enabling quick architectural review before PRs.

Core Features & Use Cases

  • Branch comparison against merge-base with main to identify impactful changes.
  • Automated UML generation: create before and after diagrams for each changed file that has a corresponding spec.
  • Spec-driven location: uses the spec-driver to locate spec files within specs folders.
  • Syntax validation: checks PlantUML syntax to ensure diagrams render correctly.
  • Use Case: When preparing a PR, visualize architecture shifts.

Quick Start

Run the skill on your feature branch to generate before/after PlantUML diagrams for changed specs.

Frequently Asked Questions about branch-uml-diagrams

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

FAQPage Schema
How do I generate PlantUML diagrams for code changes on a feature branch?

To generate PlantUML diagrams for code changes, this skill computes diffs against the merge-base with main, resolves corresponding spec files, and creates before/after diagrams for each modified file. It then validates PlantUML syntax to ensure diagrams render correctly.

What is the best way to visualize architecture shifts before a pull request?

Visualizing architecture shifts before a pull request is done by comparing your feature branch to the main merge-base. The skill identifies meaningful changes and outputs before/after PlantUML diagrams for relevant specs, enabling quick architectural review.

How do PlantUML diagrams get mapped to modified files in a tracked specs codebase?

PlantUML diagrams are mapped to modified files using a spec-driver workflow. The skill computes the branch diff, resolves corresponding spec files located within specs folders, and generates the PlantUML files directly in those spec directories.

Can I validate PlantUML syntax automatically when generating branch diff diagrams?

Yes, you can validate PlantUML syntax automatically during branch diff diagram generation. The skill includes a syntax validation step that checks the generated before and after PlantUML files to ensure they render correctly before review.

Does this automated UML generation work without manually specifying spec file locations?

Automated UML generation works without manual spec file location inputs by using the spec-driver workflow. It automatically locates corresponding spec files within specs folders for each modified file detected from the branch diff.

Why are before and after PlantUML diagrams needed for feature branch changes?

Before and after PlantUML diagrams are needed to quickly highlight architectural changes. By comparing the merge-base with the feature branch, the diagrams clearly show the structural shifts triggered by code changes for quick review.