plantuml-manipulator

Insert blocks after groups and add participants across PlantUML sequence diagram files.

1|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/skempken/plantuml-manipulator --skill plantuml-manipulator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plantuml-manipulator
Source: https://github.com/skempken/plantuml-manipulator/tree/main/docs/skill
Command: npx skills add https://github.com/skempken/plantuml-manipulator --skill plantuml-manipulator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the complex and often error-prone task of managing and updating numerous PlantUML sequence diagrams. It eliminates the need for manual, repetitive edits across dozens of files when introducing new system components, business rules, or validation steps, thereby saving significant time and ensuring documentation consistency.

Core Features & Use Cases

  • Batch Structural Changes: Effortlessly insert code blocks after specific groups or add new participants across multiple PlantUML files simultaneously.
  • Automated Validation: Automatically check if all diagrams conform to required structures, such as the presence of specific groups or participants.
  • Comprehensive Reporting: Generate detailed overviews of groups and participants within your diagrams, aiding in analysis and maintenance.
  • Use Case: Imagine a new compliance requirement dictates adding a 'Data Anonymization' step to 20 different process diagrams. Instead of manually editing each file, this Skill can insert the required PlantUML block into all relevant diagrams with a single command, ensuring every diagram is updated correctly and consistently.

Quick Start

Use the plantuml-manipulator skill to insert the content of 'snippets/new-validation.puml' after the group 'Process request' in all PlantUML files within the 'processes/' directory. Ensure to skip files that already contain 'Perform validation' and create backups of the original files.

Frequently Asked Questions about plantuml-manipulator

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

FAQPage Schema
How do I automate bulk edits across multiple PlantUML sequence diagrams?

Bulk edits in PlantUML diagrams are automated by inserting code blocks after specific groups or adding participants across files simultaneously. This Skill provides a command-line interface to apply structural changes to dozens of files in a single operation, eliminating manual editing and ensuring consistency.

Can I update PlantUML diagrams without manually editing each file?

Yes. This Skill automates repetitive structural modifications across multiple PlantUML files, such as inserting validation steps or new participants after designated groups. A single command applies changes to all matching files while supporting dry-run and backup options for safety.

What's the best way to validate PlantUML diagrams for required structure?

Automated validation checks if all diagrams conform to required structures, such as the presence of specific groups or participants. This generates a comprehensive report of existing groups and participants across your diagram collection, helping identify documentation gaps and inconsistencies.

How do I add a new component to 20 PlantUML process diagrams at once?

Use batch insertion to add a new participant or code block after a specific group across all PlantUML files in a directory. The Skill applies the change uniformly with filtering options like --skip-if-exists to avoid duplicates and --backup to preserve originals.

Does this tool support safe batch modifications with rollback options?

Yes. This Skill supports dry-run mode to preview changes before applying them, automatic backups of original files, and filtering flags like --skip-if-exists and --only-if-has-participant to ensure precise, reversible operations across multiple diagrams.