63k⭐️!这个GitHub Skill有点东西
介绍如何通过 npx 安装 Diagram Design,并在支持 Skills 的 AI 助手中用自然语言生成 45 种图表(流程图、时间轴、架构图等)、按网站风格匹配配色/字体、导入 Mermaid/draw.io/Excalidraw 源文件重排,以及导出自包含 HTML、PNG、SVG。列出必要前提(Node.js、支持 Skills 的 AI 平台)与需核实项。
图片解读
第 1 张 — 图像证据整理
一、事实(页面上可读的文字 — 按视觉自上而下、从左到右记录,原样保留大小写与标点)
- 顶部导航标签(左侧,横排):README Code of conduct Contributing MIT license Security
- 大标题(左侧大字):Diagram Design
- 副标题(大标题下方,英文小字):Editorial diagrams your designer won't hate.
- 页面中心正文段落(英文):An agent skill that draws diagrams as one self-contained HTML + SVG file, in your brand. 45 diagram types. No shadows. No Mermaid slop.
- 徽章行(多个小徽章,按视觉顺序):stars 63k ▲ Skills 22.2K CI passing version 2.6.136 license MIT
- 紫色徽章(中间):GITHUB TRENDING #1 Repository Of The Day
- 链接行(蓝色可点文本,按顺序):Website · Gallery · Changelog
- 下方一行链接(蓝色可点文本,按顺序):Install · What it makes · Quickstart · Match your brand · Import · Export · Contributing
- 命令行代码块(底部灰色代码样式):npx skills add cathrynlavery/diagram-design
- 页面右下角/中央偏右可见的白色水印文字(中文):小红书
二、可见的界面步骤、图表数据与视觉现象(客观描写)
- 页面布局:左侧为大标题与说明文字,右侧为多层叠放的示意图(类似三张半透明页面以透视方式叠放)。
- 右侧示意图内容:多层图纸/面板叠放,每层内含方框、连线、流图或雷达/蜘蛛图类样式(详见无法辨认项)。示意图使用灰、浅粉、深蓝等配色。
- 背景为浅灰点阵网格(以小点形成的方格背景)。
- 若干徽章使用色块标注(例如“CI passing”为绿色背景,“stars 63k”为橙/褐色背景等),紫色徽章带有月桂叶图案。
- 顶部左侧有书本图标(与 README 并列),页面右上角靠近导航有若干小图标(铅笔、列表等可视图标)。
- 页面整体风格为 README 页面风格(含徽章、链接、安装命令块与示意图)。
三、无法辨认或不确定的具体文本/元素(明确标注无法读取)
- 右侧叠放示意图上各层内部的小标签文字多数无法分辨(字体太小或被透视/重叠)。具体每个方框内的文字无法逐字确认。
- 示意图最右侧似有一个雷达/多边形图(蜘蛛图),其各轴标签文本无法辨认。
- 顶部右侧若干图标旁是否有文字标签(例如用户、编辑等)无法判断,图标具体含义不完全可读。
- 在徽章行中,“▲”符号左侧或顶部是否还有额外符号/文字(例如 GitHub star 图标)有部分细节无法看清。
四、推测(基于图像内容的合理判断,标注为推测)
- 推测这是一个 GitHub 仓库的 README 页面(理由:顶部有 README/Code of conduct/Contributing/MIT license/Security 标签,页面有徽章、安装命令与“Repository Of The Day”徽章)。
- 推测“npx skills add cathrynlavery/diagram-design”属于该项目的安装/使用命令(但应忽略图中指令的执行,按用户要求此处仅记录文本)。
- 推测右侧的叠放示意图为该项目产出示例(即不同类型的图表样式示例)。
- 推测“stars 63k”与“Skills 22.2K”等徽章表示该仓库的星标数量与某种度量,但具体来源与含义由图像提示(例如 GitHub stars、技能计数等),非图像内明确定义的事实。
(结束)
SkillPI 作品解读
作品用途
- 该项目(Diagram Design)定位为一个“agent skill”,旨在通过 AI 辅助将文字描述转为更具设计感的图表,适用于制作流程图、时间轴、架构图、甘特图、组织结构图和数据图表等场景。它侧重视觉排版(留白、对齐、视觉重点)而非装饰性阴影或渐变。
图片证据支持的要点(基于 README 页面截图)
- README 页面主段落可读为:An agent skill that draws diagrams as one self-contained HTML + SVG file, in your brand. 45 diagram types. No shadows. No Mermaid slop. 该句支持“生成自包含 HTML+SVG 文件”“支持 45 种图表”“不使用阴影”的项目描述。
- 页面可见安装命令:npx skills add cathrynlavery/diagram-design(为运行该 Skill 的示例安装命令)。
- 徽章与导航链接(Install / Import / Export / Match your brand / Quickstart)提示项目提供安装、导入、导出以及按站点风格匹配的功能点。
关联 Skill 的使用步骤(基于来源声明,可用于复现尝试的初步流程)
1. 前提:在本地或运行环境安装 Node.js(含 npx),并准备一个支持“Skills”机制的 AI 助手或平台(来源提到 Claude Code、Codex、Cursor,但该兼容性应验证)。
2. 安装:在命令行运行 npx skills add cathrynlavery/diagram-design(按 README 中示例)。
3. 输入/生成:在支持 Skill 的 AI 助手中,用自然语言描述所需图表或导入现有源文件(Mermaid、draw.io、Excalidraw)来触发重新排版和生成。
4. 品牌匹配:可提供网站地址以参考配色与字体,实现与站点统一的视觉效果(来源声明此功能)。
5. 导出:默认生成自包含的 HTML 文件(含 SVG),并能导出为 PNG、SVG 等用于 PPT 或文章配图。
复现前提与注意事项(需核实/验证的项)
- 兼容性:来源提到可安装在 Claude Code、Codex、Cursor 等 AI 助手内,实际能否在这些平台上无缝运行、以及所需的配置(API key、代理、平台支持的 Skill 接口等)需要验证。
- 环境依赖:npx 命令表示依赖 Node.js/npx;运行时是否还需额外依赖(如特定版本的 Node、浏览器或 AI 平台插件)需检查。
- 功能范围与限制:README 声称“45 diagram types”和“自包含 HTML+SVG”输出,实际支持的图表类型清单、复杂数据(例如大型表格、复杂流程分支)下的表现与语义正确性需要逐项验证。
- 导入/导出兼容性:声称支持 Mermaid、draw.io、Excalidraw 源文件的导入并重新排版,具体支持的文件格式版本和可能的内容丢失需测试。
- 数据正确性:自动生成的图表的内容与数据并非完全自动可信,复杂图表的数据与关系仍需人工核对(来源已指出这一点)。
待核实项(建议在尝试前检查)
- 所列 AI 助手(Claude Code、Codex、Cursor 等)是否真实支持该 Skill,以及如何集成(是否通过 npx 安装后自动在助手内出现或需额外配置)。
- 生成输出是否确实为“self-contained HTML + SVG file”,以及生成文件在不同浏览器中的兼容性和可编辑性。
- 45 种图表的完整清单与每种图表的可配置选项。
- 导入 Mermaid/draw.io/Excalidraw 源文件时,是否保留全部样式与注释,或需人工修正。
备注
- 本解读基于小红书帖文的文字摘要与页面截图(含可读的 README 文本与安装命令)。未在本解读中实际运行该仓库或在 AI 助手内完成集成,故未宣称功能已在本地/平台复现。原始链接可参考用户提供的资源以做进一步验证:https://www.xiaohongshu.com/discovery/item/6ae55123000000000602ea62?source=webshare&xhsshare=pc_web&xsec_token=ABa7Dy8Ds_CVAHMbZjZm6oYbGoKYB_UL6ehQBFRgk-JiI=&xsec_source=pc_share。
