drawio-story-sync

Synchronize DrawIO story maps with story-graph data via Python API and CLI.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill drawio-story-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drawio-story-sync
Source: https://github.com/agilebydesign/agilebydesign-skills/tree/main/skills/drawio-story-sync
Command: npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill drawio-story-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires story_graph_ops, diagram_story_sync, and includes scripts (resource) components.

What problem does it solve?

Keeps DrawIO story diagrams in sync with the underlying story-graph data, ensuring diagrams reflect the current graph state and changes are traceable.

Core Features & Use Cases

  • Render and synchronize outline, exploration, and increment diagrams from story-graph.json using validated graph I/O and domain mappings.
  • Generate update reports and apply per-story diagram changes to the graph, then re-render companion diagrams as needed.
  • CLI and Python API support for rendering, diffing, syncing, and layout extraction to streamline CI workflows and diagram maintenance.

Quick Start

Render an outline from story-graph.json and then run a sync to apply updates and refresh companion diagrams.

Frequently Asked Questions about drawio-story-sync

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

FAQPage Schema
How do I keep DrawIO diagrams in sync with story graph data?

You can keep DrawIO diagrams in sync with story graph data by rendering, diffing, and updating diagrams directly from story-graph.json. This ensures your visual story maps reflect the current validated graph state with traceable changes.

What is the best way to automate DrawIO story map updates in a CI workflow?

Automating DrawIO story map updates in CI workflows is done using the CLI and Python API. They support rendering, diffing, syncing, and layout extraction to streamline diagram maintenance and apply per-story changes automatically.

Can I render exploration and outline diagrams from a story graph?

Yes, you can render outline, exploration, and increment diagrams from story-graph.json. The process uses validated graph I/O and domain mappings to generate accurate visual representations of your story data.

How does diagram diffing work when updating story graph data?

Diagram diffing works by generating update reports that apply per-story diagram changes to the graph. After applying updates, the system re-renders companion diagrams as needed to maintain visual consistency.

Do I need story-graph-ops to sync DrawIO story maps?

Yes, story-graph-ops is required to sync DrawIO story maps. It provides the validated graph I/O operations necessary to read, update, and maintain the underlying story-graph.json data accurately.

Why are my DrawIO companion diagrams not refreshing after a story map update?

Companion diagrams may not refresh if the sync process was incomplete. Running a full sync applies per-story diagram changes to the graph and re-renders companion diagrams to ensure all views reflect the latest state.