update-architectural-diagrams

Regenerate Excalidraw architecture diagrams by surveying the codebase and diffing against existing diagrams.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Tzeusy/butlers --skill update-architectural-diagrams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-architectural-diagrams
Source: https://github.com/Tzeusy/butlers/tree/main/.claude/skills/update-architectural-diagrams
Command: npx skills add https://github.com/Tzeusy/butlers --skill update-architectural-diagrams

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures your project's architecture diagrams accurately reflect the current codebase, preventing documentation drift and aiding in understanding complex systems.

Core Features & Use Cases

  • Automated Diagram Generation: Creates or updates Excalidraw diagrams based on codebase analysis.
  • Codebase Surveying: Analyzes rostered butlers, core components, dashboard routers, and connectors.
  • Use Case: After adding a new microservice or modifying a core component, run this Skill to automatically update the system topology and component diagrams.

Quick Start

Use the update-architectural-diagrams skill to refresh all architecture diagrams in the project.

Frequently Asked Questions about update-architectural-diagrams

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

FAQPage Schema
How do I keep architecture diagrams up-to-date with codebase changes?

To keep architecture diagrams up-to-date, this Skill surveys your codebase and diffs changes against existing Excalidraw diagrams. It automatically regenerates system topology and component diagrams to prevent documentation drift after modifying core components or butlers.

What is the best way to automate Excalidraw diagram generation from a codebase?

Automating Excalidraw diagram generation involves orchestrating worker processes to analyze your codebase and diff against existing diagrams. This approach automatically produces or updates topology and connector designs based on detected structural changes.

Does this documentation automation work for microservices and connectors?

Yes, this documentation automation works for microservices, connectors, and dashboard routers. It surveys these rostered components to generate accurate butler specifications and core component deep-dive diagrams in Excalidraw format.

How does codebase surveying update system topology diagrams?

Codebase surveying updates system topology diagrams by analyzing structural changes and diffing them against existing Excalidraw files. It orchestrates worker processes to produce updated diagrams reflecting current butlers, modules, and core components.

When should I run an architecture diagram regeneration process?

You should run architecture diagram regeneration after adding a new microservice or modifying a core component. This ensures your Excalidraw documentation accurately reflects current system topology and prevents knowledge drift in complex systems.