Create detailed, auditable, and interactive sequence diagrams of a codebase in minutes

Browsing a sequence and following a code citation link to GitHub

Installation · Usage · Examples · Why Ilograph · Discussion

This repository contains agent skills for creating detailed, auditable, and interactive Ilograph sequence diagrams of a codebase.

Installation

/plugin marketplace add ilograph/skills

/plugin install ilograph-skills

npx skills add ilograph/skills

Usage

Creating diagrams of a codebase

Open a code repository and run

/generate-ilograph

After analyzing the codebase, the agent will prompt you to choose which system flows to diagram. The number of suggested flows will vary with the size and complexity of the codebase.

Once complete, your Ilograph diagrams will be written to ilograph.yaml. Paste the contents of this file as a new diagram into the Ilograph web app (online version), Ilograph for Desktop (offline version), or Ilograph for Confluence Cloud.

Updating existing diagrams

To keep diagram content and code references in sync with the codebase, run

/update-ilograph

This will update the ilograph.yaml file in place.

Examples

Helm Dashboard	Vaultwarden	Zed

Why Ilograph

Interactivity & Detail

Ilograph diagrams are interactive and zoomable, allowing coding agents to include far more detail than is possible with static, image-based diagrams.

Auditability

Steps in the flows generated with these skills include code references to specific lines in the codebase, ensuring that each flow can be audited for accuracy.

Scalability

Sequence flows in Ilograph diagrams can be nested, meaning there is practically no limit to how large and detailed they can be.

Stability

Ilograph diagrams are defined in a declarative syntax (YAML), allowing both humans and agents to iterate on existing diagrams instead of re-creating them from scratch when a codebase changes.

Discussion

Please join the Ilograph Discussion on GitHub to share feedback and ideas.