🎨 OpenClaw Skill Graph Visualizer

可视化你的 OpenClaw Skills 依赖关系

🐍 Python 3.8+ 📊 D3.js 可视化 🔄 循环依赖检测 📄 Markdown 报告

🎯 工具简介

OpenClaw Skill Graph Visualizer 是一个强大的依赖关系可视化工具,帮助开发者理解和优化他们的 OpenClaw Skill 架构。

通过解析 SKILL.md 文件,自动提取工具引用、文件依赖、显式声明,生成交互式 D3.js 力导向图和详细分析报告。

✨ 功能特性

🔍 自动扫描

解析 SKILL.md 文件,提取所有元数据(描述、工具、依赖)

🕸️ 交互式依赖图

基于 D3.js 的力导向图,支持拖拽、缩放、悬停详情

🔄 循环依赖检测

自动发现并报告循环依赖,避免架构问题

📊 统计报告

生成详细的 Markdown 报告,包含架构建议

🎯 精准解析

提取工具引用、文件依赖、显式声明

🚀 零依赖

只需 Python 3.8+ 和现代浏览器,D3.js 通过 CDN 加载

🚀 快速开始

# 1. 克隆仓库
git clone https://github.com/jingchang0623-crypto/openclaw-skill-graph-visualizer.git
cd openclaw-skill-graph-visualizer

# 2. 直接使用
python3 skill_graph_visualizer.py --skills-dir ~/.openclaw/skills --output ./output

# 3. 打开可视化
open output/skill-dependency-graph.html
⭐ GitHub 仓库 📖 在线文档

📋 使用示例

基本用法

# 分析默认 Skills 目录
python3 skill_graph_visualizer.py

# 指定自定义目录
python3 skill_graph_visualizer.py --skills-dir ./my-skills

# 指定输出目录
python3 skill_graph_visualizer.py --output ./reports

输出文件

output/
├── skill-dependency-graph.html # 交互式 D3.js 可视化
└── dependency-report.md # 详细分析报告

🎯 适用场景

  • Skill 开发者 - 了解你的 Skill 依赖哪些其他 Skill
  • 架构师 - 发现并消除循环依赖
  • 社区管理者 - 生成社区 Skills 全景图
  • 新手入门 - 快速了解 OpenClaw 生态中的热门 Skills

🧠 技术原理

  1. 扫描 SKILL.md - 遍历目录,解析每个 Skill 的元信息
  2. 提取依赖 - 分析代码块中的工具引用、文件链接、Dependencies 章节
  3. 构建图结构 - 使用 NetworkX 风格的依赖图
  4. 检测循环 - DFS 算法检测循环依赖
  5. 可视化输出 - D3.js 力导向图 + 统计 HTML

🚀 关于妙趣AI

妙趣AI (miaoquai.com) 是专业的 OpenClaw 生态合作伙伴,提供:

  • 📚 OpenClaw 中文教程 - 从入门到精通
  • 🛠️ 开源工具开发 - 提升开发效率
  • 🔍 SEO 优化服务 - 让更多人发现你的 Skill
  • 🤝 社区运营支持 - 连接开发者与用户
🌐 访问妙趣AI ⭐ GitHub 组织