Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
Document Codex and opencode skill installs
tt-a1i2736652e793a
diff --git a/README.md b/README.mdindex ff3dadfd..97fad418 100644--- a/README.md+++ b/README.md@@ -4,7 +4,7 @@**Generate beautiful architecture, technical workflow, sequence, data-flow, and lifecycle diagrams in chat. Switch dark / light. Copy to clipboard or export crisp up-to-4× PNG / JPEG / WebP / SVG.**-Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude) that turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.+Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.- **No design skills needed** — describe your architecture in English, get a diagram- **Workflow, sequence, data-flow, and lifecycle diagrams too** — technical flows, approvals, tool calls, CI/CD, runbooks, request call chains, data pipelines, PII boundaries, and state machines can be drawn@@ -16,7 +16,7 @@ Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-usin- **Iterate by chat** — "add Redis", "move auth to the left", "use emerald for the API"-+**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)@@ -117,7 +117,7 @@ Archify is based on [Cocoon-AI/architecture-diagram-generator](https://github.co### 1. Install the skill-> Requires Claude Pro, Max, Team, or Enterprise plan (or Claude Code).+Archify is packaged as an agent skill directory (`archify/SKILL.md`), so the same [`archify.zip`](archify.zip) works with Claude, Codex CLI, and opencode.**Claude.ai:**1. Download [`archify.zip`](archify.zip)@@ -134,10 +134,31 @@ unzip archify.zip -d ~/.claude/skills/unzip archify.zip -d ./.claude/skills/```-The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the skill directory. Claude installs it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:+**Codex CLI:**+```bash+# Global (all projects)+unzip archify.zip -d ~/.agents/skills/++# Or project-local+unzip archify.zip -d ./.agents/skills/+```++**opencode:**+```bash+# Global (opencode-native)+unzip archify.zip -d ~/.config/opencode/skills/++# Or project-local+unzip archify.zip -d ./.opencode/skills/++# Also works: the shared agent directory used above for Codex+unzip archify.zip -d ~/.agents/skills/+```++The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the installed skill directory. Many agent runtimes can run it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:```bash-cd ~/.claude/skills/archify && npm install+cd ~/.agents/skills/archify && npm install```Without the dependency the renderers skip schema validation (layout checks still run).@@ -150,6 +171,8 @@ What each install surface can do:| Install surface | Capability ||---|---|| **Claude Code** | Full — runs the typed renderers + schema validation |+| **Codex CLI** | Full — install to `~/.agents/skills/` or `.agents/skills/` |+| **opencode** | Full — install to `.opencode/skills/`, `.agents/skills/`, or another supported skills directory || **Claude.ai (zip upload)** | Usually full — depends on whether the sandbox can `npm install`, which it typically can || **Project Knowledge** | Architecture mode only — no code execution, purely prompt-driven |diff --git a/README_EN.md b/README_EN.mdindex ff3dadfd..97fad418 100644--- a/README_EN.md+++ b/README_EN.md@@ -4,7 +4,7 @@**Generate beautiful architecture, technical workflow, sequence, data-flow, and lifecycle diagrams in chat. Switch dark / light. Copy to clipboard or export crisp up-to-4× PNG / JPEG / WebP / SVG.**-Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude) that turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.+Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.- **No design skills needed** — describe your architecture in English, get a diagram- **Workflow, sequence, data-flow, and lifecycle diagrams too** — technical flows, approvals, tool calls, CI/CD, runbooks, request call chains, data pipelines, PII boundaries, and state machines can be drawn@@ -16,7 +16,7 @@ Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-usin- **Iterate by chat** — "add Redis", "move auth to the left", "use emerald for the API"-+**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)@@ -117,7 +117,7 @@ Archify is based on [Cocoon-AI/architecture-diagram-generator](https://github.co### 1. Install the skill-> Requires Claude Pro, Max, Team, or Enterprise plan (or Claude Code).+Archify is packaged as an agent skill directory (`archify/SKILL.md`), so the same [`archify.zip`](archify.zip) works with Claude, Codex CLI, and opencode.**Claude.ai:**1. Download [`archify.zip`](archify.zip)@@ -134,10 +134,31 @@ unzip archify.zip -d ~/.claude/skills/unzip archify.zip -d ./.claude/skills/```-The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the skill directory. Claude installs it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:+**Codex CLI:**+```bash+# Global (all projects)+unzip archify.zip -d ~/.agents/skills/++# Or project-local+unzip archify.zip -d ./.agents/skills/+```++**opencode:**+```bash+# Global (opencode-native)+unzip archify.zip -d ~/.config/opencode/skills/++# Or project-local+unzip archify.zip -d ./.opencode/skills/++# Also works: the shared agent directory used above for Codex+unzip archify.zip -d ~/.agents/skills/+```++The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the installed skill directory. Many agent runtimes can run it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:```bash-cd ~/.claude/skills/archify && npm install+cd ~/.agents/skills/archify && npm install```Without the dependency the renderers skip schema validation (layout checks still run).@@ -150,6 +171,8 @@ What each install surface can do:| Install surface | Capability ||---|---|| **Claude Code** | Full — runs the typed renderers + schema validation |+| **Codex CLI** | Full — install to `~/.agents/skills/` or `.agents/skills/` |+| **opencode** | Full — install to `.opencode/skills/`, `.agents/skills/`, or another supported skills directory || **Claude.ai (zip upload)** | Usually full — depends on whether the sandbox can `npm install`, which it typically can || **Project Knowledge** | Architecture mode only — no code execution, purely prompt-driven |diff --git a/README_ZH.md b/README_ZH.mdindex 92b09b96..201c0709 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -4,7 +4,7 @@**聊两句就画出好看的架构图、技术流程图、调用时序图、数据流图和生命周期图。深色 / 浅色一键切。导出最高 4× 清晰 PNG / JPEG / WebP / SVG,或直接复制到剪贴板。**-Archify 是一个 [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude):你用大白话描述自己的系统或流程,它就把你的描述变成一张做工精细的技术图 —— 一个单文件 HTML,在浏览器里打开就能切主题、复制到剪贴板、导出成各种图片格式。+Archify 是一个可用于 Claude、Codex CLI 和 opencode 的 agent skill:你用大白话描述自己的系统或流程,它就把你的描述变成一张做工精细的技术图 —— 一个单文件 HTML,在浏览器里打开就能切主题、复制到剪贴板、导出成各种图片格式。- **不需要会画图** —— 把组件和连接关系说给 Claude 就行- **支持 workflow / sequence / data flow / lifecycle** —— 技术流程、审批链、工具调用、CI/CD、请求调用链、数据管线、PII 边界、状态机都可以画@@ -16,7 +16,7 @@ Archify 是一个 [Claude Skill](https://support.claude.com/en/articles/12512180- **聊天迭代** —— "把 Redis 挪到左边"、"鉴权服务换成玫红"、"加个 Kafka"-+**[在线落地页 → tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)**@@ -119,7 +119,7 @@ Archify 基于 [Cocoon-AI/architecture-diagram-generator](https://github.com/Coc### 1. 安装 skill-> 需要 Claude Pro / Max / Team / Enterprise 套餐,或 Claude Code。+Archify 打包成标准 agent skill 目录(`archify/SKILL.md`),同一个 [`archify.zip`](archify.zip) 可以用于 Claude、Codex CLI 和 opencode。**Claude.ai:**1. 下载 [`archify.zip`](archify.zip)@@ -138,10 +138,31 @@ unzip archify.zip -d ~/.claude/skills/unzip archify.zip -d ./.claude/skills/```-类型化渲染器(workflow / sequence / dataflow / lifecycle)依赖 ajv 做 schema 校验,需要在 skill 目录执行一次 `npm install`。首次使用时 Claude 会按 `SKILL.md` 的 Setup 指引自动安装;也可以自己先装好:+**Codex CLI:**+```bash+# 全局(所有项目可用)+unzip archify.zip -d ~/.agents/skills/++# 或者仅当前项目+unzip archify.zip -d ./.agents/skills/+```++**opencode:**+```bash+# 全局(opencode 原生目录)+unzip archify.zip -d ~/.config/opencode/skills/++# 或者仅当前项目+unzip archify.zip -d ./.opencode/skills/++# 也可以复用上面 Codex 的通用 agent 目录+unzip archify.zip -d ~/.agents/skills/+```++类型化渲染器(workflow / sequence / dataflow / lifecycle)依赖 ajv 做 schema 校验,需要在安装后的 skill 目录执行一次 `npm install`。很多 agent runtime 首次使用时会按 `SKILL.md` 的 Setup 指引自动安装;也可以自己先装好:```bash-cd ~/.claude/skills/archify && npm install+cd ~/.agents/skills/archify && npm install```没装依赖时渲染器会跳过 schema 校验(布局检查仍然运行)。@@ -154,6 +175,8 @@ cd ~/.claude/skills/archify && npm install| 安装方式 | 能力 ||---|---|| **Claude Code** | 完整 —— 可运行类型化渲染器 + schema 校验 |+| **Codex CLI** | 完整 —— 安装到 `~/.agents/skills/` 或 `.agents/skills/` |+| **opencode** | 完整 —— 安装到 `.opencode/skills/`、`.agents/skills/` 或其他支持的 skills 目录 || **Claude.ai 上传 zip** | 通常可用 —— 取决于沙箱能否 `npm install`,一般可以 || **Project Knowledge** | 仅架构模式 —— 不执行代码,纯 prompt 驱动 |diff --git a/docs/index.html b/docs/index.htmlindex acdd706b..bec69ff5 100644--- a/docs/index.html+++ b/docs/index.html@@ -4,7 +4,7 @@<meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Archify — Architecture Diagrams from Plain English</title>- <meta name="description" content="A Claude Skill that turns plain-English descriptions into polished, self-contained HTML architecture diagrams with dark/light themes, clipboard copy, and 4× export.">+ <meta name="description" content="An agent skill for Claude, Codex CLI, and opencode that turns plain-English descriptions into polished, self-contained HTML architecture diagrams with dark/light themes, clipboard copy, and 4× export."><meta name="theme-color" content="#020617"><link rel="icon" type="image/svg+xml" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 28 28'><polygon points='14,2 26,8 26,20 14,26 2,20 2,8' fill='%23083344' stroke='%2322d3ee' stroke-width='1.5'/><circle cx='14' cy='15' r='2.5' fill='%2322d3ee'/></svg>">@@ -216,7 +216,7 @@<div class="container"><div class="hero-badge fade-up"><div class="pulse-dot"></div>- <span data-i18n="hero-badge">Claude Skill · v2.6.0</span>+ <span data-i18n="hero-badge">Agent Skill · v2.6.0</span></div><h1 class="fade-up d1" data-i18n="hero-h1">From plain English<br>to architecture <em>in seconds.</em></h1><p class="hero-sub fade-up d2" data-i18n="hero-sub">Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.</p>@@ -462,13 +462,13 @@<div><div class="section-label fade-up" data-i18n="label-qs">Quick Start</div><h2 class="section-heading fade-up d1" data-i18n="qs-h2">Up and running<br>in three steps.</h2>- <p class="section-body fade-up d2" style="margin-bottom:2.5rem" data-i18n="qs-body">Requires Claude Pro, Max, Team, or Enterprise — or Claude Code CLI.</p>+ <p class="section-body fade-up d2" style="margin-bottom:2.5rem" data-i18n="qs-body">Works with Claude, Codex CLI, and opencode.</p><div class="steps"><div class="step fade-up d1"><div class="step-num">1</div><div class="step-content"><h4 data-i18n="step1-h">Install the Skill</h4>- <p data-i18n="step1-p">Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>, go to Claude Settings → Capabilities → Skills, click + Add and upload it. Or unzip to ~/.claude/skills/ for CLI use.</p>+ <p data-i18n="step1-p">Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>. Upload it in Claude Settings, or unzip it for CLI agents: ~/.claude/skills/ for Claude Code, ~/.agents/skills/ for Codex, ~/.config/opencode/skills/ or .opencode/skills/ for opencode.</p></div></div><div class="step fade-up d2">@@ -570,7 +570,7 @@ this description.</span>const LANGS = {en: {'nav-docs':'Docs','nav-install':'Install Skill',- 'hero-badge':'Claude Skill · v2.6.0',+ 'hero-badge':'Agent Skill · v2.6.0','hero-h1':'From plain English<br>to architecture <em>in seconds.</em>','hero-sub':'Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.','hero-cta':'Get started','hero-gh':'View on GitHub',@@ -615,8 +615,8 @@ this description.</span>'chip-external':'External','chip-external-use':'Users, 3rd parties, generic','label-qs':'Quick Start','qs-h2':'Up and running<br>in three steps.',- 'qs-body':'Requires Claude Pro, Max, Team, or Enterprise — or Claude Code CLI.',- 'step1-h':'Install the Skill','step1-p':'Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>, go to Claude Settings → Capabilities → Skills, click + Add and upload it. Or unzip to ~/.claude/skills/ for CLI use.',+ 'qs-body':'Works with Claude, Codex CLI, and opencode.',+ 'step1-h':'Install the Skill','step1-p':'Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>. Upload it in Claude Settings, or unzip it for CLI agents: ~/.claude/skills/ for Claude Code, ~/.agents/skills/ for Codex, ~/.config/opencode/skills/ or .opencode/skills/ for opencode.','step2-h':'Describe your system','step2-p':'Write a plain-English description of your architecture — components, connections, cloud services. Or ask Claude to analyze your codebase first.','step3-h':'Ask Claude to draw it','step3-p':'Tell Claude to use the Archify skill. It generates a self-contained HTML file you open in any browser. Iterate from there — in plain English.','code-label':'example prompt',@@ -626,7 +626,7 @@ this description.</span>},zh: {'nav-docs':'文档','nav-install':'安装技能',- 'hero-badge':'Claude 技能 · v2.6.0',+ 'hero-badge':'Agent 技能 · v2.6.0','hero-h1':'用自然语言,<br>秒级生成<em>架构图。</em>','hero-sub':'在对话中描述你的系统,Archify 生成精美、独立的 HTML 架构图——内置深色/浅色主题、一键复制剪贴板、超清 4× 图片导出。','hero-cta':'快速开始','hero-gh':'在 GitHub 查看',@@ -671,8 +671,8 @@ this description.</span>'chip-external':'外部系统','chip-external-use':'用户、第三方、通用外部','label-qs':'快速开始','qs-h2':'三步上手,<br>即刻运行。',- 'qs-body':'需要 Claude Pro、Max、Team 或 Enterprise 计划,或 Claude Code CLI。',- 'step1-h':'安装技能','step1-p':'下载 <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>,进入 Claude 设置 → 能力 → 技能,点击「+ 添加」上传。或解压至 ~/.claude/skills/ 供 CLI 使用。',+ 'qs-body':'支持 Claude、Codex CLI 和 opencode。',+ 'step1-h':'安装技能','step1-p':'下载 <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>。Claude 可在设置里上传;CLI agent 可解压到对应目录:Claude Code 用 ~/.claude/skills/,Codex 用 ~/.agents/skills/,opencode 用 ~/.config/opencode/skills/ 或 .opencode/skills/。','step2-h':'描述你的系统','step2-p':'用自然语言描述你的架构——组件、连接关系、云服务。也可以先让 Claude 分析你的代码仓库。','step3-h':'让 Claude 绘制','step3-p':'告诉 Claude 使用 Archify 技能,它会生成独立的 HTML 文件,用任意浏览器打开即可。然后继续用自然语言迭代。','code-label':'示例提示词',