Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

docs: sharpen README first impression

tt-a1i0562a20d5179
diff --git a/README.md b/README.md
index 2d2bb02a..8ebaa4dc 100644
--- a/README.md
+++ b/README.md
@@ -12,16 +12,11 @@
**Turn plain-English system descriptions into polished architecture, workflow, sequence, data-flow, and lifecycle diagrams — directly in chat.**
-Archify is an agent skill for Claude, Codex CLI, and opencode. It produces a self-contained HTML diagram that opens in any modern browser, switches between dark and light themes, supports focused exploration, and exports clean static or motion assets.
-
-- **Five diagram types** — architecture, workflow, sequence, data flow, and lifecycle
-- **Three live visual presets** — author a default, then try `classic`, `signal-flow`, or `blueprint` on the same topology
-- **Explore real topology** — search nodes by label or stable ID, inspect relationships, trace routes, compare roles, and play guided stories
-- **Motion is optional** — output stays static unless `meta.animation: "trace"` is explicitly enabled
-- **Portable exports** — create, copy, or download a 1200×630 Share Card; turn a resolved route into a focused Route Share Card; or export PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM
-- **Typed and checked** — JSON IR, bundled schema validation, default semantic safety gates, and opt-in composition profiles
-- **Self-contained output** — one shareable HTML file with no viewer runtime dependency
-- **Built for agent workflows** — install once, then create and refine diagrams through conversation; optionally open only the verified final artifact
+Archify is an agent skill for Claude, Codex CLI, and opencode. Give it a system description or repository; get a polished diagram you can open, explore, present, and share.
+
+- **Open it and present** — five technical diagram types, three visual presets, dark/light themes, and optional finite motion
+- **Every interaction stays grounded** — search nodes, inspect relationships, trace authored routes, compare roles, and play guided stories without inventing topology
+- **One file, ready to trust and share** — typed JSON IR and deterministic checks produce self-contained HTML plus PNG, SVG, WebM, and 1200×630 share cards
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)
diff --git a/README_EN.md b/README_EN.md
index 2d2bb02a..8ebaa4dc 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -12,16 +12,11 @@
**Turn plain-English system descriptions into polished architecture, workflow, sequence, data-flow, and lifecycle diagrams — directly in chat.**
-Archify is an agent skill for Claude, Codex CLI, and opencode. It produces a self-contained HTML diagram that opens in any modern browser, switches between dark and light themes, supports focused exploration, and exports clean static or motion assets.
-
-- **Five diagram types** — architecture, workflow, sequence, data flow, and lifecycle
-- **Three live visual presets** — author a default, then try `classic`, `signal-flow`, or `blueprint` on the same topology
-- **Explore real topology** — search nodes by label or stable ID, inspect relationships, trace routes, compare roles, and play guided stories
-- **Motion is optional** — output stays static unless `meta.animation: "trace"` is explicitly enabled
-- **Portable exports** — create, copy, or download a 1200×630 Share Card; turn a resolved route into a focused Route Share Card; or export PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM
-- **Typed and checked** — JSON IR, bundled schema validation, default semantic safety gates, and opt-in composition profiles
-- **Self-contained output** — one shareable HTML file with no viewer runtime dependency
-- **Built for agent workflows** — install once, then create and refine diagrams through conversation; optionally open only the verified final artifact
+Archify is an agent skill for Claude, Codex CLI, and opencode. Give it a system description or repository; get a polished diagram you can open, explore, present, and share.
+
+- **Open it and present** — five technical diagram types, three visual presets, dark/light themes, and optional finite motion
+- **Every interaction stays grounded** — search nodes, inspect relationships, trace authored routes, compare roles, and play guided stories without inventing topology
+- **One file, ready to trust and share** — typed JSON IR and deterministic checks produce self-contained HTML plus PNG, SVG, WebM, and 1200×630 share cards
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)
diff --git a/README_ZH.md b/README_ZH.md
index 5d24da34..41806e13 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -8,16 +8,11 @@
**在对话里,把自然语言描述变成漂亮、可靠的架构图、工作流图、时序图、数据流图和生命周期图。**
-Archify 是一个可用于 Claude、Codex CLI 和 opencode 的 Agent Skill。它生成单文件 HTML 技术图:浏览器直接打开,可切换深浅主题、聚焦探索真实拓扑,并导出清晰的静态或动态结果。
-
-- **五种图表类型** —— Architecture、Workflow、Sequence、Data Flow、Lifecycle
-- **三套实时视觉预设** —— 先确定作者默认风格,再在同一拓扑上试穿 `classic`、`signal-flow` 或 `blueprint`
-- **探索真实拓扑** —— 按名称或稳定 ID 搜索节点、检查关系、探查路径、对比角色、播放引导故事
-- **动态默认关闭** —— 只有显式设置 `meta.animation: "trace"` 才启用动态
-- **便携导出** —— 一键生成、复制或下载 1200×630 Share Card;把已解析路径导出为聚焦的 Route Share Card;也可导出 PNG / JPEG / WebP / 双主题 SVG / WebM
-- **Typed + Checked** —— Typed JSON IR、内置 Schema 校验、默认语义安全门禁和可选构图档位
-- **结果完全独立** —— 一个 HTML 文件即可查看和分享,不依赖 Viewer 服务
-- **适合 Agent 工作流** —— 安装一次,通过对话持续生成和细调;需要时只打开已经验证的最终成品
+Archify 是适用于 Claude、Codex CLI 和 opencode 的 Agent Skill。给它一段系统描述或一个代码仓库,就能得到可打开、可探索、可演示、可分享的专业技术图。
+
+- **打开就是成品** —— 五种技术图、三套视觉预设、深浅主题,以及显式启用的有限动态
+- **每次探索都有依据** —— 搜索节点、检查关系、追踪作者路径、对比角色、播放故事,但不编造拓扑
+- **一个文件即可放心交付** —— Typed JSON IR 和确定性校验生成独立 HTML,并支持 PNG、SVG、WebM 与 1200×630 分享卡片
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)