Archify - Setup Guide¶

Source: skills.sh (32.5K installs) GitHub: tt-a1i/archify (39,204⭐, MIT) Category: Architecture & Diagrams First Seen: May 11, 2026 (skills.sh) Quality Tier: 🟢 Production (Gen Agent Trust Hub Pass / Socket Pass / Snyk Pass)

Archify creates self-contained, interactive HTML diagrams - architecture, workflow, sequence, dataflow, and lifecycle - from a small typed JSON specification. Static output is the default; motion is opt-in for demos and presentations. The unusual part is the quality gate: a bundled CLI (node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json) checks every artifact against 9 checks with 0 composition errors before handoff, and deliver is the final acceptance command. One of the highest-starred single-skill repos on skills.sh (39.2K⭐ vs 32.5K installs).

Installation¶

npx skills add tt-a1i/archify --skill archify

Workflow¶

Choose the diagram type (architecture, workflow, sequence, dataflow, lifecycle)
Read the matching schema + one example from the skill's schemas/ and examples/ directories
Write the candidate JSON artifact first (max ~12 primary nodes, one clear main path, sparse labels)
Validate: node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json - showcase requires all 9 artifact checks, 0 composition errors, 0 warnings
Deliver: deliver is the final acceptance command for the rendered HTML
Brand marks: node bin/archify.mjs brands "<name>" --json for real product identity

Schema version 2 is the current authoring contract for workflows; version 1 is preserved only for fixed-geometry legacy diagrams.

Prerequisites¶

Node.js (for the bundled bin/archify.mjs validation CLI)
No API keys or external services - output is a self-contained HTML file

CorpusIQ Use Cases¶

Architecture docs - CorpusIQ's data-connector and agent-orchestration architecture pages become interactive, verifiable diagrams instead of static images
Investor/operator decks - motion-enabled workflow diagrams for demos and presentations
Verifiable diagram quality - the validate-before-deliver gate is the diagram equivalent of CorpusIQ's pre-publish content gates

Integration with CorpusIQ¶

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects

Limitations / Verification¶

JSON-spec authoring is a different muscle than Mermaid/D2 text syntax - budget a short learning pass on schemas/
Static default keeps output light; motion must be explicitly requested per the SKILL.md
Verify install: npx skills list | grep archify

Security¶

Gen Agent Trust Hub: Pass · Socket: Pass · Snyk: Pass