archifycommit edf158c · v3.2SKILL.md · Architecture Tuning
Archify Diagrams
Builds checked standalone HTML diagrams in ten types, like architecture or ERD, from requirements, Mermaid or repo evidence, or a one-page explainer.
If the user accepts proactive mode, it adds a line to the agent's global rules file such as ~/.claude/CLAUDE.md.
npx skills add tt-a1i/archify --skill archifyCommand selected. Copy it manually.
- Permissions
- read-repo
- write-files
- shell
- network
- Compatible with
- Claude Code, Codex, Cursor, OpenCode
- GitHub
- 92.2k
- Source
- Community · tt-a1i
- Status
- Scan passed
- License
- Apache-2.0
- Category
- Architecture Tuning
- Repository
- github.com/tt-a1i/archify/archify
Core rule
A non-zero finalize exit is never success; repair the failed gate and rerun the complete command.
Execution Phases
Phase 01Choose the artifact
Pick one of ten native diagram types or an explainer page from the question, using the guide command when ambiguous.
Phase 02Read schema and evidence
Read the matching schema, example and authoring defaults; for a real codebase, trace source files as evidence.
Phase 03Write the candidate
Write a complete candidate.json or explainer draft into its own folder under .archify/.
Phase 04Run finalize
One run covers validate, deliver, strict check and a real-browser check; on failure read the receipt, repair and rerun.
Phase 05Report briefly
Lead with a link to the HTML and add only what changes how it should be read, without recapping commands or checks.
Permissions (summarised from SKILL.md)
| Capability | Needed | Details |
|---|---|---|
| File writes | Limited | Writes candidates and HTML into folders under .archify/ in the working directory; with user consent it adds one line to the global agent rules file. |
| Command execution | Limited | Runs node bin/archify.mjs subcommands such as finalize, guide and doctor, including a real-browser check. |
| Network outbound | Limited | finalize runs a bounded update check, and unknown brand marks are fetched only from a user-provided URL; updates are never installed automatically. |
SKILL.md frontmatter (YAML)
---
name: archify
description: "Create validated architecture, workflow, sequence, data-flow, lifecycle/state, ERD, class, tree, timeline, and waterfall diagrams as explorable standalone HTML with dark/light themes, motion and image/SVG/WebM export. Accept requirements or Mermaid; inspect repository evidence for code-backed diagrams. Use when visualizing systems, API calls, pipelines, schemas, histories, timings, or everyday steps, parts, relationships and states. Also turn an answer into a one-page explainer, with the conclusion first, structured panels, native diagrams and charts, when the user asks for a page, an explainer or an answer to share (做成一页, 用页面讲), or proactively when the user's rules opt in with an [archify explainer: ...] line. Not for dashboards."
license: Apache-2.0
metadata:
version: "3.2"
author: tt-a1i
---