ClaudeMap

blueprint

把「X 是怎么工作的」画成维多利亚风专利图动画的 Claude Code skill——部件随编号引线逐一绘入、每步一句大白话,可导出 GIF、MP4 或 PNG

技能与命令skillexplaineranimationsvgtechnical illustration

Blueprint 是一个 Claude Code skill:给它一个主题,它会返回一幅老专利图风格的动画解释——28 件部件的部件库(抽屉、柜子、齿轮、闸门、锁、时钟、队列等)、编号引线、沿线运动的东西、每步一句大白话。解释锚定一个具体案例、以「但是…于是…」的推理链展开:缓存的例子从 120 毫秒的查询讲起,落到 2 毫秒的抽屉命中。成图由一个零依赖运行时承载,既可以是单页里的 <blueprint-scene> 元素(loop/view/click/still 播放模式、蓝晒或亚麻纸面、编号部件表、速度控制、支持减弱动效),也可以由 scripts/build.mjs 打成独立 HTML。检查器 scripts/check.mjs 抓未知 id、空场景、没被绘制的部件、部件重叠、引线穿过部件或文字、闸门撞上别的东西。导出路径覆盖 GIF(README/Slack)、MP4(ffmpeg 或 Chromium WebCodecs)、2 倍 PNG,以及给幻灯片的逐步 PNG;事故图引用的 sources 会列在图下而不画进导出。事故模板能把复盘文档变成一条以时间线收尾的成套叙事。仓库含 10 个 small 与 11 个 complex 示例、画廊页与独立网站;风格出处与打包致谢在 README 中写明。需 Node 18+;Playwright(锁定 1.56.1)可选,仅帧渲染与导出需要。

它做什么

  • 提示词入口:/blueprint 讲讲缓存怎么工作、把注册流程画给文档页、为什么重试风暴把 API 打垮,或把复盘文档交给事故模板
  • 28 件部件库配编号引线、每步一句大白话;每个部件都要靠一个具体案例及其「但是…于是…」链条挣得位置
  • 自带检查器与渲染:scripts/check.mjs 对未知 id、未绘制或重叠部件、引线穿字、闸门相撞报错;Playwright 让 Claude 渲帧自查
  • 嵌入面:零依赖运行时上的 <blueprint-scene> 元素(loop/view/click/still、蓝晒或亚麻纸、部件表、速度、减弱动效),或由 build.mjs 打出的单文件 HTML
  • 导出:GIF、MP4(ffmpeg 或 Chromium WebCodecs)、2 倍 PNG、给幻灯片的逐步 PNG;--audio 可配音轨;事故图的 sources 以链接列在图下,不烧进导出

什么时候用

适合概念、事故或内部流程需要一张读者可逐步看完的自解释图——文档页、README、事故复盘、演讲。需要图表工具的可编辑产物或实时数据请绕行;每一幅都是手工布局的场景,不是自动生成的图。

如何上手

经 skills CLI 安装:

npx skills add intincrab/blueprint

或克隆进 skills 目录:

git clone https://github.com/intincrab/blueprint.git ~/.claude/skills/blueprint

需 Node 18+。Playwright 可选(渲染帧与 GIF/MP4/PNG 导出才需要);在 skill 目录里一次性装好:

cd ~/.claude/skills/blueprint
npm i
npx playwright install chromium

检查与构建只要 Node:

node scripts/check.mjs <scene.js>
node scripts/build.mjs examples/small/cache.js --out cache.html

离线或发行版自带 Chromium:用 BLUEPRINT_CHROMIUM 指向其二进制,免下载。

注意事项

Linux 上 MP4 导出需要 ffmpeg(该平台 Playwright 的 Chromium 无 H.264 编码器),--audio 也可能回落到 ffmpeg;macOS 上 Chromium 的 WebCodecs 即可。运行时默认从 Google Fonts 加载 IBM Plex Mono——加 no-font(或 --no-font)可做完全离线的页面。多场景文件默认只导出第一个场景,需用 --scene 选取。按 README,你用该 skill 做的场景归你所有。MIT 许可。撰稿时 58 星(2026-11-21)。

代码仓库

intincrab/blueprint

收录日期

地图上的相关资源

  • SureForge

    技能

    纯指令式 skill:让 agent 先调研再提问、先规划再动手、先验证再说「做完了」。

    • workflow
    • verification
    • quality
    • skill
  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap