CodeariaAcademy
GitHub repositorycommit this monthDevelopmentDesignAnalytics

Archify

86k

One of the best skills for mapping a project: the agent in Claude Code, Cursor or Codex explores the code, finds services and links, draws architecture, workflow and sequence diagrams, and runs nine checks before handing them over.

We installed the skill and ran it on Node 22.14: everything worked with no changes.

In numbers

checks before a diagram ships
diagram types
licence
version as of 4 September 2026

What it is

Archify is not a diagram editor but a skill for an agent. It installs into Claude Code, Cursor, Codex CLI or opencode, and from then on the agent understands "draw how our payment flow works": it reads the code itself, finds the services and links, and returns an interactive HTML diagram with node search and path tracing.

The main difference from "ask a model to draw it" is that the model does not draw the picture. The agent writes a small typed JSON, the renderer turns it into SVG deterministically, and before delivery a validator catches arrows that cut through an unrelated node and labels that land on a neighbouring line. The agent gets a rule code, repairs and re-checks, so what reaches you is an already checked diagram. It is a tool for an agent and a terminal, not a Figma replacement.

How it works

npx skills add
One command, npx skills add tt-a1i/archify -g, installs the skill into Claude Code, Cursor, Codex CLI or opencode.
JSON → SVG
The agent writes typed JSON for one of five types (architecture, workflow, sequence, data flow, lifecycle), the renderer compiles it to SVG, and the same file always gives the same picture.
validator
Nine checks from schema to geometry; on a failure it returns a rule code and supported fixes.
compare
Nodes can be pinned to files and line ranges at a specific commit, and compare shows what was added, removed and moved between two versions of a diagram.
export
Dark and light themes, export to PNG, SVG, WebM and 1200×630 share cards.

Know before installing

Needs Node 18 or newer.
It reads Mermaid but is not a Mermaid theme. WYSIWYG editing and hosted sharing are out of scope by design.

Comments