Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
TypeScript antigravity-skillsbusiness-knowledgeclaude-codeclaude-skillscodebase-analysiscodexcodex-skillsdeveloper-tools-ai-agentgemini-cli-skillskarpathy-llm-wikiknowledge-baseknowledge-graphmemoryopencode-skillspi-agentunderstandcodevibe-coding
refactor: unify skills install method across all platforms
Lum1104c8d92444e2ae
diff --git a/.antigravity/INSTALL.md b/.antigravity/INSTALL.mdindex 5516be23..2c7681a6 100644--- a/.antigravity/INSTALL.md+++ b/.antigravity/INSTALL.md@@ -11,16 +11,20 @@git clone https://github.com/Lum1104/Understand-Anything.git ~/.antigravity/understand-anything```-2. **Create the skills symlink:**+2. **Create the skills symlinks:**```bashmkdir -p ~/.gemini/antigravity/skillsln -s ~/.antigravity/understand-anything/understand-anything-plugin/skills ~/.gemini/antigravity/skills/understand-anything+ # Universal plugin root symlink — lets the dashboard skill find packages/dashboard/+ # Skip if already exists (e.g. another platform was installed first)+ [ -e ~/.understand-anything-plugin ] || [ -L ~/.understand-anything-plugin ] || ln -s ~/.antigravity/understand-anything/understand-anything-plugin ~/.understand-anything-plugin```**Windows (PowerShell):**```powershellNew-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini\antigravity\skills"cmd /c mklink /J "$env:USERPROFILE\.gemini\antigravity\skills\understand-anything" "$env:USERPROFILE\.antigravity\understand-anything\understand-anything-plugin\skills"+ cmd /c mklink /J "$env:USERPROFILE\.understand-anything-plugin" "$env:USERPROFILE\.antigravity\understand-anything\understand-anything-plugin"```3. **Restart the chat or IDE** so Antigravity can discover the skills.@@ -52,5 +56,6 @@ Skills update instantly through the symlink.```bashrm ~/.gemini/antigravity/skills/understand-anything+rm ~/.understand-anything-pluginrm -rf ~/.antigravity/understand-anything```diff --git a/.codex/INSTALL.md b/.codex/INSTALL.mdindex 155ade1c..bc4e9a24 100644--- a/.codex/INSTALL.md+++ b/.codex/INSTALL.md@@ -11,16 +11,29 @@git clone https://github.com/Lum1104/Understand-Anything.git ~/.codex/understand-anything```-2. **Create the skills symlink:**+2. **Create the skills symlinks:**```bashmkdir -p ~/.agents/skills- ln -s ~/.codex/understand-anything/understand-anything-plugin/skills ~/.agents/skills/understand-anything+ # Note: if OpenCode's Understand-Anything is already installed, these symlinks+ # already exist and the ln commands will safely fail — that is fine, the+ # existing symlinks work for Codex too.+ for skill in understand understand-chat understand-dashboard understand-diff understand-explain understand-onboard; do+ ln -sf ~/.codex/understand-anything/understand-anything-plugin/skills/$skill ~/.agents/skills/$skill+ done+ # Universal plugin root symlink — lets the dashboard skill find packages/dashboard/+ # Skip if already exists (e.g. another platform was installed first)+ [ -e ~/.understand-anything-plugin ] || [ -L ~/.understand-anything-plugin ] || ln -s ~/.codex/understand-anything/understand-anything-plugin ~/.understand-anything-plugin```**Windows (PowerShell):**```powershellNew-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"- cmd /c mklink /J "$env:USERPROFILE\.agents\skills\understand-anything" "$env:USERPROFILE\.codex\understand-anything\understand-anything-plugin\skills"+ $skills = @("understand","understand-chat","understand-dashboard","understand-diff","understand-explain","understand-onboard")+ foreach ($skill in $skills) {+ cmd /c mklink /J "$env:USERPROFILE\.agents\skills\$skill" "$env:USERPROFILE\.codex\understand-anything\understand-anything-plugin\skills\$skill"+ }+ # Universal plugin root symlink+ cmd /c mklink /J "$env:USERPROFILE\.understand-anything-plugin" "$env:USERPROFILE\.codex\understand-anything\understand-anything-plugin"```3. **Restart Codex** to discover the skills.@@ -28,10 +41,10 @@## Verify```bash-ls -la ~/.agents/skills/understand-anything+ls -la ~/.agents/skills/ | grep understand```-You should see a symlink pointing to the skills directory.+You should see symlinks for each skill pointing into the cloned repository.## Usage@@ -45,11 +58,14 @@ Skills activate automatically when relevant. You can also invoke directly:cd ~/.codex/understand-anything && git pull```-Skills update instantly through the symlink.+Skills update instantly through the symlinks.## Uninstalling```bash-rm ~/.agents/skills/understand-anything+for skill in understand understand-chat understand-dashboard understand-diff understand-explain understand-onboard; do+ rm -f ~/.agents/skills/$skill+done+rm ~/.understand-anything-pluginrm -rf ~/.codex/understand-anything```diff --git a/.openclaw/INSTALL.md b/.openclaw/INSTALL.mdindex f06d566d..d3150a62 100644--- a/.openclaw/INSTALL.md+++ b/.openclaw/INSTALL.md@@ -11,16 +11,20 @@git clone https://github.com/Lum1104/Understand-Anything.git ~/.openclaw/understand-anything```-2. **Create the skills symlink:**+2. **Create the skills symlinks:**```bashmkdir -p ~/.openclaw/skillsln -s ~/.openclaw/understand-anything/understand-anything-plugin/skills ~/.openclaw/skills/understand-anything+ # Universal plugin root symlink — lets the dashboard skill find packages/dashboard/+ # Skip if already exists (e.g. another platform was installed first)+ [ -e ~/.understand-anything-plugin ] || [ -L ~/.understand-anything-plugin ] || ln -s ~/.openclaw/understand-anything/understand-anything-plugin ~/.understand-anything-plugin```**Windows (PowerShell):**```powershellNew-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw\skills"cmd /c mklink /J "$env:USERPROFILE\.openclaw\skills\understand-anything" "$env:USERPROFILE\.openclaw\understand-anything\understand-anything-plugin\skills"+ cmd /c mklink /J "$env:USERPROFILE\.understand-anything-plugin" "$env:USERPROFILE\.openclaw\understand-anything\understand-anything-plugin"```3. **Restart OpenClaw** to discover the skills.@@ -41,5 +45,6 @@ cd ~/.openclaw/understand-anything && git pull```bashrm ~/.openclaw/skills/understand-anything+rm ~/.understand-anything-pluginrm -rf ~/.openclaw/understand-anything```diff --git a/.opencode/INSTALL.md b/.opencode/INSTALL.mdindex 3fa6645f..e462957b 100644--- a/.opencode/INSTALL.md+++ b/.opencode/INSTALL.md@@ -2,55 +2,86 @@## Prerequisites-- [OpenCode.ai](https://opencode.ai) installed+- Git+- [OpenCode](https://opencode.ai) installed## Installation-Add understand-anything to the `plugin` array in your `opencode.json` (global or project-level):--```json-{- "plugin": ["understand-anything@git+https://github.com/Lum1104/Understand-Anything.git"]-}-```--Restart OpenCode. The plugin auto-installs and registers all skills.+1. **Clone the repository:**+ ```bash+ git clone https://github.com/Lum1104/Understand-Anything.git ~/.opencode/understand-anything+ ```++2. **Create the skills symlinks:**+ ```bash+ mkdir -p ~/.agents/skills+ # Note: if Codex's Understand-Anything is already installed, these symlinks+ # already exist and the ln commands will safely fail — that is fine, the+ # existing symlinks work for OpenCode too.+ for skill in understand understand-chat understand-dashboard understand-diff understand-explain understand-onboard; do+ ln -sf ~/.opencode/understand-anything/understand-anything-plugin/skills/$skill ~/.agents/skills/$skill+ done+ # Universal plugin root symlink — lets the dashboard skill find packages/dashboard/+ # Skip if already exists (e.g. another platform was installed first)+ [ -e ~/.understand-anything-plugin ] || [ -L ~/.understand-anything-plugin ] || ln -s ~/.opencode/understand-anything/understand-anything-plugin ~/.understand-anything-plugin+ ```++ **Windows (PowerShell):**+ ```powershell+ New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"+ $skills = @("understand","understand-chat","understand-dashboard","understand-diff","understand-explain","understand-onboard")+ foreach ($skill in $skills) {+ cmd /c mklink /J "$env:USERPROFILE\.agents\skills\$skill" "$env:USERPROFILE\.opencode\understand-anything\understand-anything-plugin\skills\$skill"+ }+ # Universal plugin root symlink+ cmd /c mklink /J "$env:USERPROFILE\.understand-anything-plugin" "$env:USERPROFILE\.opencode\understand-anything\understand-anything-plugin"+ ```++3. **Restart OpenCode** to discover the skills.## Verify-Ask: "List available skills" — you should see understand, understand-chat, understand-dashboard, etc.+```bash+ls -la ~/.agents/skills/ | grep understand+```++You should see symlinks for each skill pointing into the cloned repository.## Usage+Skills activate automatically when relevant. You can also invoke directly:+```-use skill tool to load understand-anything/understand+use skill tool to load understand```Or just ask: "Analyze this codebase and build a knowledge graph"## Updating-Restart OpenCode — the plugin re-installs from git automatically.--To pin a specific version:--```json-{- "plugin": ["understand-anything@git+https://github.com/Lum1104/Understand-Anything.git#v1.1.1"]-}+```bash+cd ~/.opencode/understand-anything && git pull```+Skills update instantly through the symlinks.+## Uninstalling-Remove the plugin line from `opencode.json` and restart.+```bash+for skill in understand understand-chat understand-dashboard understand-diff understand-explain understand-onboard; do+ rm -f ~/.agents/skills/$skill+done+rm ~/.understand-anything-plugin+rm -rf ~/.opencode/understand-anything+```## Troubleshooting### Skills not found-1. Verify the plugin line in your `opencode.json`-2. Check that `~/.cache/opencode/node_modules/understand-anything` exists after restart-3. Use the `skill` tool to list discovered skills+1. Check that the symlinks exist: `ls -la ~/.agents/skills/ | grep understand`+2. Verify the clone succeeded: `ls ~/.opencode/understand-anything/understand-anything-plugin/skills/`+3. Restart OpenCode### Tool mappingdiff --git a/.opencode/plugins/understand-anything.js b/.opencode/plugins/understand-anything.jsdeleted file mode 100644index 43378f62..00000000--- a/.opencode/plugins/understand-anything.js+++ /dev/null@@ -1,25 +0,0 @@-/**- * Understand Anything plugin for OpenCode.ai- *- * Auto-registers the skills directory so OpenCode discovers all- * understand-anything skills without manual symlinks or config edits.- */--import path from 'path';-import { fileURLToPath } from 'url';--const __dirname = path.dirname(fileURLToPath(import.meta.url));--export const UnderstandAnythingPlugin = async ({ client, directory }) => {- const skillsDir = path.resolve(__dirname, '../../understand-anything-plugin/skills');-- return {- config: async (config) => {- config.skills = config.skills || {};- config.skills.paths = config.skills.paths || [];- if (!config.skills.paths.includes(skillsDir)) {- config.skills.paths.push(skillsDir);- }- },- };-};diff --git a/README.ja-JP.md b/README.ja-JP.mdindex 4540a579..9a1b5618 100644--- a/README.ja-JP.md+++ b/README.ja-JP.md@@ -122,11 +122,9 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und### OpenCode-`opencode.json` に以下を追加:-```json-{- "plugin": ["understand-anything@git+https://github.com/Lum1104/Understand-Anything.git"]-}+OpenCodeに以下を伝えてください:+```+Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md```### OpenClaw@@ -153,7 +151,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und|----------|--------|----------------|| Claude Code | ✅ ネイティブ | プラグインマーケットプレイス || Codex | ✅ サポート | AI駆動インストール |-| OpenCode | ✅ サポート | プラグイン設定 |+| OpenCode | ✅ サポート | AI駆動インストール || OpenClaw | ✅ サポート | AI駆動インストール || Cursor | ✅ サポート | 自動検出 || Antigravity | ✅ サポート | AI駆動インストール |diff --git a/README.md b/README.mdindex a078451d..c48c4dc1 100644--- a/README.md+++ b/README.md@@ -122,11 +122,9 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und### OpenCode-Add to your `opencode.json`:-```json-{- "plugin": ["understand-anything@git+https://github.com/Lum1104/Understand-Anything.git"]-}+Tell OpenCode:+```+Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md```### OpenClaw@@ -153,7 +151,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und|----------|--------|----------------|| Claude Code | ✅ Native | Plugin marketplace || Codex | ✅ Supported | AI-driven install |-| OpenCode | ✅ Supported | Plugin config |+| OpenCode | ✅ Supported | AI-driven install || OpenClaw | ✅ Supported | AI-driven install || Cursor | ✅ Supported | Auto-discovery || Antigravity | ✅ Supported | AI-driven install |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 21746523..969e190d 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -121,11 +121,9 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und### OpenCode-添加到你的 `opencode.json` 文件:-```json-{- "plugin": ["understand-anything@git+https://github.com/Lum1104/Understand-Anything.git"]-}+告诉 OpenCode:+```+Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md```### OpenClaw@@ -152,7 +150,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Und|----------|--------|----------------|| Claude Code | ✅ Native | 插件市场 || Codex | ✅ 支持 | AI驱动安装 |-| OpenCode | ✅ 支持 | 插件配置 |+| OpenCode | ✅ 支持 | AI驱动安装 || OpenClaw | ✅ 支持 | AI驱动安装 || Cursor | ✅ 支持 | 自动发现 || Antigravity | ✅ 支持 | AI驱动安装 |diff --git a/understand-anything-plugin/skills/understand-dashboard/SKILL.md b/understand-anything-plugin/skills/understand-dashboard/SKILL.mdindex b800e84e..e0614d7c 100644--- a/understand-anything-plugin/skills/understand-dashboard/SKILL.md+++ b/understand-anything-plugin/skills/understand-dashboard/SKILL.md@@ -19,13 +19,31 @@ Start the Understand Anything dashboard to visualize the knowledge graph for theNo knowledge graph found. Run /understand first to analyze this project.```-3. Find the dashboard code. The dashboard is at `packages/dashboard/` relative to this plugin's root directory. Use the Bash tool to resolve the path:+3. Find the dashboard code. The dashboard is at `packages/dashboard/` relative to this plugin's root directory. Check these paths in order and use the first that exists:+ - `~/.understand-anything-plugin/packages/dashboard/` (universal symlink, all installs)+ - `${CLAUDE_PLUGIN_ROOT}/packages/dashboard/` (Claude Code plugin)+ - Two levels up from this skill file's real path: `../../packages/dashboard/` (self-relative fallback)++ Use the Bash tool to resolve:```bash- PLUGIN_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"+ SKILL_REAL=$(realpath ~/.agents/skills/understand-dashboard 2>/dev/null || readlink -f ~/.agents/skills/understand-dashboard 2>/dev/null || echo "")+ SELF_RELATIVE=$([ -n "$SKILL_REAL" ] && cd "$SKILL_REAL/../.." 2>/dev/null && pwd || echo "")++ PLUGIN_ROOT=""+ for candidate in \+ "$HOME/.understand-anything-plugin" \+ "${CLAUDE_PLUGIN_ROOT}" \+ "$SELF_RELATIVE"; do+ if [ -n "$candidate" ] && [ -d "$candidate/packages/dashboard" ]; then+ PLUGIN_ROOT="$candidate"; break+ fi+ done++ if [ -z "$PLUGIN_ROOT" ]; then+ echo "Error: Cannot find the understand-anything plugin root. Make sure you followed the installation instructions and that ~/.understand-anything-plugin exists."+ exit 1+ fi```- Or locate it by checking these paths in order:- - `${CLAUDE_PLUGIN_ROOT}/packages/dashboard/`- - The parent directory of this skill file, then `../../packages/dashboard/`4. Install dependencies and build if needed:```bash