archify

Generate grounded typed JSON diagram specifications and validated HTML exports via the Archify renderer.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahsanghalib/ai-workflow --skill archify-ahsanghalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: archify
Source: https://github.com/ahsanghalib/ai-workflow/tree/main/skills/archify
Command: npx skills add https://github.com/ahsanghalib/ai-workflow --skill archify-ahsanghalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating accurate architecture, workflow, sequence, data-flow, or lifecycle diagrams often produces ungrounded visuals that invent topology or drift from the actual system. This Skill enforces evidence-grounded diagram authoring through Archify's typed JSON intermediate representation, with deterministic validation and delivery when the local renderer is available. ## Core Features & Use Cases - Typed diagram authoring: Produces sparse, semantically labeled typed JSON sources for architecture, workflow, sequence, dataflow, and lifecycle diagram types. - Evidence grounding: Classifies every fact as observed, proposed, inferred, or unknown, pinning inspected repository revisions and source paths. - Renderer-gated validation and delivery: Runs the Archify runtime's validation, delivery, and export commands only when the runtime is confirmed present, with a source-only fallback otherwise. - Use Case: Ask for an architecture diagram of your repository; the Skill inspects the relevant files, records evidence and revision, authors the typed source, validates it with the local Archify runtime, and delivers a self-contained HTML artifact only after approval. ## Quick Start Use Archify to create a grounded architecture diagram of this repository and validate it with the local renderer if available.

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 with Archify?▼

Request an Archify diagram and the Skill inspects your repository files, classifies evidence as observed or proposed, authors a typed JSON source, and validates it with the local Archify runtime. Delivery of the HTML artifact happens only after your explicit approval.

What diagram types does Archify support?▼

Archify supports five primary types: architecture for components and trust boundaries, workflow for processes and approvals, sequence for API calls and request lifecycles, dataflow for pipelines and lineage, and lifecycle for states and retries.

What happens if the Archify runtime is not installed?▼

The Skill reports the capability gap and offers a source-only specification recording the intended type, nodes, relationships, and evidence. It will not claim typed-schema validation, deterministic delivery, browser evidence, or export without the renderer present.

When should I use diagram-design instead of Archify?▼

Use diagram-design for generic diagrams, Mermaid or Excalidraw redraws, and any diagram that does not require Archify's typed JSON source and renderer. Archify is reserved for explicit renderer-backed typed diagram workflows.

Can Archify export diagrams to PNG or SVG?▼

Export to PNG, SVG, WebP, WebM, or share-card formats is supported only when explicitly requested and the local Archify runtime supports it. Each export is a separate approval-gated action performed after validation and delivery.