Agent skill · Archify
/archify Turn code or a description into a checked interactive diagram
The archify skill gives an agent a fixed path from request to diagram: pick one of ten diagram types, read the matching schema and example, write a complete JSON candidate, then run a single finalize command that validates, renders and browser-checks it. Failed gates come back with exact repair hints, and the reply is a short link to the finished HTML.
Works with
- Any agent
- Cursor
- Codex
Used forDiagrams and codebase maps
When to use it
- You want a runtime architecture map of a repository with source references.
- You need a sequence, data-flow, ERD or lifecycle diagram for a design review or doc.
- You want an answer to a technical question delivered as one shareable page.
How it works
- 1Choose the artifact
The agent decides between a native diagram and an explainer page, and picks the diagram type from the question, using the bundled guide command when unsure.
- 2Read schema and example
It reads the authoring defaults, the schema and one example for that type, treating the example as shape only, never as facts to copy.
- 3Write the whole candidate
It writes the complete JSON in its own .archify/ folder, with source evidence for code-backed diagrams and strict table-first rules for ERDs.
- 4Finalize
It runs one finalize command that validates, delivers and checks the HTML in a real browser, treating any non-zero exit as a failure to repair within set limits.
- 5Reply briefly
It answers with a titled link to the HTML and notes only what changes how to read it, such as illustrative timings or omitted parts.
What it steers the agent away from
- Copying names, IDs or layout from the bundled examples into your diagram
- Claiming visual quality when only automated checks ran
- Rendering Mermaid styling mechanically instead of rebuilding its meaning
Install this skill
It installs with the Archify pack.
Any agent (guided)A prompt you paste into your agent; it follows the install instructions in that file.
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txtCursorNon-interactive global install for Cursor.
npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yesCodex (try without installing)Runs the skill for a session without a permanent install.
npx skills use tt-a1i/archify@archify --agent codexCommands come from the author’s README; check it for changes before you run them.
Questions
Can I start from a Mermaid diagram?
Yes. The skill reads Mermaid for its topology and meaning, maps each Mermaid type to the matching Archify type and authors fresh JSON.
Can I edit the diagram after it is made?
Yes. Ask for focused changes such as adding a component or highlighting a path; the agent edits the kept JSON source and finalizes again.
Summary by trendhub. The skill itself lives in tt-a1i/archify/archify by tt-a1i (Apache-2.0); read the full, current text there.