SkillInstalls cleanly

Turn ideas and code into diagrams

Archify

A skill that turns a plain description or your project's code into an interactive diagram or a one-page explainer, saved as one HTML file you can share.

Works with
Claude Code, Codex CLI
Good for
Build an app, Daily work and research

What it does

A diagram often explains a plan better than a page of text. Archify is a skill that teaches your assistant to draw them. You describe the idea in plain words, such as "the browser calls the API, the API checks a cache", and the assistant builds a clean diagram you can click through.

It can also read a project you have open and draw how its parts connect, with links back to the files it used as evidence. Since version 3.2.0 (18 October 2026) it can answer a question as a one-page explainer: the conclusion first, then one panel per question, with steps, tables, charts and diagrams.

The result is a single HTML file. You open it in your browser, switch between light and dark themes, and export an image or print it to PDF. The person you send it to does not need Archify.

To build and check each file, the skill runs a Node.js script on your computer. It then opens the file in a hidden Chrome, Chromium or Edge window and checks that nothing is cut off. Without one of these browsers, that last check is skipped and you still get the file.

About once a day Archify may fetch a small file from GitHub Pages to tell you about a new version. It never installs updates by itself. Set ARCHIFY_UPDATE_CHECK_DISABLED=1 to turn this off.

About the sponsors. The README's sponsor section promotes services that resell access to Claude, OpenAI and Gemini models at a discount through their own servers. They are not official providers. They can see everything you send through them, and using them may break the providers' terms. The README itself says these services "do not represent Archify". You do not need any of them to use Archify. We do not link to them or recommend them.

Who it is for

People who want to explain an idea, a plan or a project to someone else with a picture, and people who learn better from a diagram than from a long answer. You do not need a code project.

Example prompts

  • "Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback."
  • "Add authentication and highlight the cache-miss path."
  • "Analyze this repository, then use archify to create a high-level runtime architecture diagram."
  • "Use Archify to answer as one page: why is my website slow on the first visit?"
  • "Switch to the light theme."

How to install

npx skills add tt-a1i/archify -g

How to use it

Ask: Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback. For a page that answers a question, ask your assistant to answer as one page with Archify.

Check it works

  1. Ask for the first example prompt above.
  2. Archify should save one HTML file, and your assistant should tell you where it is.
  3. Open the file in your browser.

SKILL.md also lists node bin/archify.mjs doctor as a setup check. Run it from inside the installed skill folder.

Common problems

  • Nothing is drawn and the assistant says Node is missing — the renderer is a Node.js script — install Node.js 18 or later first (package.json).
  • The browser check is reported as skipped — no Chrome, Chromium or Edge was found — install one of them, or ignore it: the HTML file is still made (references/delivery-contract.md).
  • The skill does not start — the install went to a different assistant — use the agent switcher at archify.si/start.html, which shows the right command for Claude Code, Codex, Cursor and OpenCode (README).
  • Map links and outside websites in the file do not load — they need an internet connection; the rest of the file works offline (README).

What to watch out for

  • The README's sponsor section promotes third-party API relay services that resell Claude, OpenAI and Gemini access at a discount. They are not official providers, can see everything you send, and may break the providers' terms. Our page does not link to them or recommend them.
  • The skill runs a Node.js script (Node 18 or later) on your computer to build and check each diagram, so your assistant runs shell commands (SKILL.md, package.json)
  • To check a finished diagram it starts a hidden Chrome, Chromium or Edge window on your computer; without one of these browsers that check is skipped (references/delivery-contract.md)
  • When you ask for a diagram of a real project, your assistant reads that project's files to find the evidence (README)
  • About once a day it may fetch a small file from GitHub Pages to show an optional update reminder. The README says that server sees only your IP address and the time, no project data or prompts. ARCHIFY_UPDATE_CHECK_DISABLED=1 turns this off
  • The README lists Cursor, Claude Code, Codex CLI and OpenCode; Gemini CLI is not named

Licence and author

Licence
MIT
Author
tt-a1i
Source code
github.com/tt-a1i/archify

How we tested it

We installed it on an empty test computer on 20 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

No diagram was made, so the Node.js renderer and the Chrome check did not run. The skills CLI install itself was not run. Not yet used on real work.

Technical details of the test
Date
20 Oct 2026
Method
Intake sandbox run on 2026-10-20 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y skills --help".

Checked again on 20 Oct 2026

Alternatives

  • Diagram Design — another diagram skill; compare which output style you prefer.
  • playground — Anthropic's plugin for clickable pages where you choose options, not diagrams of a system.
  • Mermaid diagrams — many assistants can write Mermaid text without a skill; Archify adds checks, themes and export.

FAQ

Do I need a code project? No. The README says you can start from a plain description.

Is it free? Yes. The skill is free and MIT licensed. The sponsors in its README are separate paid services that we do not recommend.

Can I share the diagram? Yes. Send the HTML file, or export an image or a PDF.

Will it make pages when I did not ask? Not by default. Only if you add a line such as [archify explainer: proactive] to your assistant's rules does it make pages without being asked (SKILL.md).

Does it work in Gemini CLI? The README does not list Gemini CLI.

Sources

  • github.com/tt-a1i/archify
  • github.com/tt-a1i/archify/blob/main/archify/SKILL.md
  • github.com/tt-a1i/archify/blob/main/CHANGELOG.md
  • github.com/tt-a1i/archify/blob/main/archify/references/delivery-contract.md