# /archify: Turn code or a description into a checked interactive diagram

Source: https://trendhub.net/skills/tt-a1i-archify/archify
Skill folder: https://github.com/tt-a1i/archify/tree/main/archify
Pack: Archify (https://trendhub.net/skills/tt-a1i-archify)
Works with: Any agent (guided), Cursor, Codex (try without installing)

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.

## 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

1. **Choose 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.
2. **Read 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.
3. **Write 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.
4. **Finalize**: 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.
5. **Reply 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

## What it can touch

Reads repository files when asked for a code-backed diagram, writes candidate JSON and HTML under .archify/ in the working directory, and runs the bundled Node.js CLI including a headless browser check.

## 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.
