archify

Generate validated architecture, workflow, sequence, dataflow, and lifecycle diagrams as standalone interactive HTML.

1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/filippolmt/skills --skill archify-filippolmt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archify
Source: https://github.com/filippolmt/skills/tree/main/skills/archify
Command: npx skills add https://github.com/filippolmt/skills --skill archify-filippolmt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ajv, parse5, saxes, simple-icons, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Creating polished technical diagrams usually requires manual layout work in drawing tools, and text-based formats like Mermaid offer limited styling and no validation of visual quality. Archify turns a small typed JSON specification into a self-contained, explorable HTML diagram with deterministic validation and delivery receipts. ## Core Features & Use Cases - Five typed diagram renderers: architecture, workflow, sequence, dataflow, and lifecycle, each with a strict JSON schema, automatic orthogonal routing, and composition checks. - Validated delivery pipeline: the validate and deliver CLI commands enforce a showcase quality profile, freeze the specification, and report SHA-256 receipts plus visual-check evidence at desktop viewport sizes. - Mermaid conversion and brand marks: accepts pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input, and supports a built-in catalogue of 107 brand marks with digest-pinned capture for unknown sites. - Use Case: Ask for a diagram of your microservices deployment, and Archify authors the JSON IR, validates it against the showcase profile, and delivers a single HTML file with dark/light themes, pan/zoom, search, and PNG/SVG export. ## Quick Start Ask the assistant to create an architecture diagram of your system using archify, describing the components and their relationships in plain language.

Frequently Asked Questions about archify

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

FAQPage Schema
How do I create an architecture diagram from plain text?

Describe your system in plain language and Archify authors a typed JSON specification, choosing the architecture diagram type. It validates the candidate with the archify CLI and delivers a self-contained HTML file with inline SVG, themes, and export options.

Can I convert Mermaid diagrams to interactive HTML?

Yes, Archify accepts pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input. It reads the Mermaid for topology and meaning, then authors fresh Archify JSON rendered as interactive HTML rather than copying Mermaid styling.

What diagram types does archify support?

Archify supports five typed renderers: architecture for components and boundaries, workflow for processes and approval gates, sequence for API call chains, dataflow for pipelines and lineage, and lifecycle for state transitions.

Does archify require npm install or network access?

No install is required inside the skill package; validators are pre-generated and shipped with the skill, so runtime validation has no npm or network dependency. You can verify the setup with node bin/archify.mjs doctor.

Why does archify validation fail with composition errors?

Showcase validation fails when routes cross unrelated nodes, labels collide with routes, or segments fall below minimum lengths. Fix only the diagnosed subject using the supportedFixes in the receipt, then rerun validate until the error count reaches zero.