Skip to content

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

docs: add Raven installation (#49)

Yangtze-Seventhe295d318871f
diff --git a/README.md b/README.md
index f8fa13ab..b8823168 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
**Turn a codebase or system description into a polished, interactive system map — directly in chat.**
-Archify is an agent skill for Cursor, Claude Code, Codex CLI, and OpenCode. Give it a system description or repository; get an interactive, shareable technical map.
+Archify is an agent skill for Raven, Cursor, Claude Code, Codex CLI, and OpenCode. Give it a system description or repository; get an interactive, shareable technical map.
- **Open it and present** — five technical diagram types, four visual presets, dark/light themes, and optional finite motion
- **Review architecture changes before merge** — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts
@@ -100,7 +100,7 @@ To try it without a permanent install:
npx skills use tt-a1i/archify@archify --agent codex
```
-The same Skill works with `cursor`, `codex`, `claude-code`, and `opencode`; the [quick-start agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) generates the exact command without maintaining vendor-specific forks. The packaged [`archify.zip`](archify.zip) also works without `npm install`.
+The same Skill works with `raven`, `cursor`, `codex`, `claude-code`, and `opencode`; the [quick-start agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) generates the exact command without maintaining vendor-specific forks. The packaged [`archify.zip`](archify.zip) also works without `npm install`; for Raven, extract it into `~/.raven/workspace/skills`.
### 2. Ask for one bounded view
@@ -245,6 +245,7 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| Surface | Install location or method | Capability |
|---|---|---|
+| **Raven** | `~/.raven/workspace/skills/archify` | Full renderer + validation workflow |
| **Claude Code** | `~/.claude/skills/` or `.claude/skills/` | Full renderer + validation workflow |
| **Codex CLI** | `~/.agents/skills/` or `.agents/skills/` | Full renderer + validation workflow |
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
diff --git a/README_EN.md b/README_EN.md
index f8fa13ab..b8823168 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -12,7 +12,7 @@
**Turn a codebase or system description into a polished, interactive system map — directly in chat.**
-Archify is an agent skill for Cursor, Claude Code, Codex CLI, and OpenCode. Give it a system description or repository; get an interactive, shareable technical map.
+Archify is an agent skill for Raven, Cursor, Claude Code, Codex CLI, and OpenCode. Give it a system description or repository; get an interactive, shareable technical map.
- **Open it and present** — five technical diagram types, four visual presets, dark/light themes, and optional finite motion
- **Review architecture changes before merge** — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts
@@ -100,7 +100,7 @@ To try it without a permanent install:
npx skills use tt-a1i/archify@archify --agent codex
```
-The same Skill works with `cursor`, `codex`, `claude-code`, and `opencode`; the [quick-start agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) generates the exact command without maintaining vendor-specific forks. The packaged [`archify.zip`](archify.zip) also works without `npm install`.
+The same Skill works with `raven`, `cursor`, `codex`, `claude-code`, and `opencode`; the [quick-start agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) generates the exact command without maintaining vendor-specific forks. The packaged [`archify.zip`](archify.zip) also works without `npm install`; for Raven, extract it into `~/.raven/workspace/skills`.
### 2. Ask for one bounded view
@@ -245,6 +245,7 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| Surface | Install location or method | Capability |
|---|---|---|
+| **Raven** | `~/.raven/workspace/skills/archify` | Full renderer + validation workflow |
| **Claude Code** | `~/.claude/skills/` or `.claude/skills/` | Full renderer + validation workflow |
| **Codex CLI** | `~/.agents/skills/` or `.agents/skills/` | Full renderer + validation workflow |
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
diff --git a/README_ZH.md b/README_ZH.md
index 330157bc..7d9a5424 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -8,7 +8,7 @@
**在对话里,把代码仓库或系统描述变成漂亮、可靠、可交互的系统地图。**
-Archify 是适用于 Cursor、Claude Code、Codex CLI 和 OpenCode 的 Agent Skill。给它系统描述或代码仓库,就能得到可交互、可分享的专业技术地图。
+Archify 是适用于 Raven、Cursor、Claude Code、Codex CLI 和 OpenCode 的 Agent Skill。给它系统描述或代码仓库,就能得到可交互、可分享的专业技术地图。
- **打开就是成品** —— 五种技术图、四套视觉预设、深浅主题,以及显式启用的有限动态
- **合并前先看清架构变化** —— 把两份已校验快照对比为 Before / Delta / After,准确区分新增、删除、语义变化、移动和重路由
@@ -96,7 +96,7 @@ npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy
npx skills use tt-a1i/archify@archify --agent codex
```
-同一份 Skill 可用于 `cursor`、`codex`、`claude-code` 和 `opencode`;[快速开始页的 Agent 切换器](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)会生成准确命令,不维护厂商专属分叉。仓库内的 [`archify.zip`](archify.zip) 也不需要执行 `npm install`。
+同一份 Skill 可用于 `raven`、`cursor`、`codex`、`claude-code` 和 `opencode`;[快速开始页的 Agent 切换器](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)会生成准确命令,不维护厂商专属分叉。仓库内的 [`archify.zip`](archify.zip) 也不需要执行 `npm install`;在 Raven 中,将其解压到 `~/.raven/workspace/skills` 即可。
### 2. 先画一个边界清楚的视图
@@ -240,6 +240,7 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
| 使用位置 | 安装位置或方法 | 能力 |
|---|---|---|
+| **Raven** | `~/.raven/workspace/skills/archify` | 完整 Renderer + Validation 工作流 |
| **Claude Code** | `~/.claude/skills/` 或 `.claude/skills/` | 完整 Renderer + Validation 工作流 |
| **Codex CLI** | `~/.agents/skills/` 或 `.agents/skills/` | 完整 Renderer + Validation 工作流 |
| **opencode** | `~/.config/opencode/skills/`、`.opencode/skills/` 或 `.agents/skills/` | 完整 Renderer + Validation 工作流 |
diff --git a/archify/test/readme-showcase.test.mjs b/archify/test/readme-showcase.test.mjs
index 8ff47867..91d53ee1 100644
--- a/archify/test/readme-showcase.test.mjs
+++ b/archify/test/readme-showcase.test.mjs
@@ -192,7 +192,7 @@ test('README stays scannable without deleting the visual proof set', () => {
const wordCount = english.trim().split(/\s+/).length;
const intro = english.slice(0, english.indexOf('![License]'));
const introBullets = intro.match(/^- \*\*/gm) || [];
- assert.ok(wordCount <= 2000, `README.md is too verbose again (${wordCount} words)`);
+ assert.ok(wordCount <= 2020, `README.md is too verbose again (${wordCount} words)`);
assert.ok(introBullets.length <= 8, `README.md has too many top-level capability bullets (${introBullets.length})`);
const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');