dotslashsimran/simcraft

项目介绍

simcraft 是一组 Claude Code 技能，每个技能是一个文件夹，内含 SKILL.md 来说明方法、判断要点和实际可用的脚本。技能分为 Video、Engineering、Learning、Design、Planning 五类。当请求与某个技能匹配时，Claude Code 会自动加载；skill-router 可以在多阶段任务中串联两到三个技能，让前一个的输出交给后一个使用（skill-router）。

代表性技能包括：

• 视频：用 perspective-illusion 制作日式视觉错觉风的 3D 循环动画，用 code-loop 把 three.js 场景或 GLSL 着色器渲染成无缝循环，用 rough-cut 从原始口播素材剪出初剪，用 clean-audio 先测量再做人声清理。
• 工程：用 codebase-map 快速梳理陌生仓库的一次真实请求链路，用 bisect-anything 把回归问题缩小到具体 hunk，用 flaky-test-killer 找出不稳定测试的根因而非依赖重试，用 benchmark-honestly 做带置信区间的基准测试。
• 学习与设计：paper-to-runnable、system-design-from-scratch、image-gen、brand-kit 等。

快速使用

准备条件：Python 3.9+、Node 18+，以及 PATH 中可用的 ffmpeg（或用 FFMPEG 环境变量指定路径）。README 给出的安装步骤（安装步骤）：

git clone https://github.com/dotslashsimran/simcraft ~/simcraft
mkdir -p ~/.claude/skills
for s in ~/simcraft/skills/*/*/; do ln -s "${s%/}" ~/.claude/skills/; done
cd ~/simcraft && npm i

Claude Code 只会向下查找一层文件夹，因此循环把每个技能目录都软链到 ~/.claude/skills；只装单个技能时，链接对应文件夹即可。部分技能带一次性安装脚本，例如 rough-cut 的 Whisper 用 setup.sh，具体在每个 SKILL.md 顶部说明。链接完成后，相关请求会自动加载对应技能，skill-router 可以组合出 reverse-engineer-video → code-loop、benchmark-honestly → bisect-anything 这类链条。

使用约束

• 多数脚本只用 Python 标准库，但驱动浏览器和渲染视频的技能需要 Node 18+，视频与音频技能依赖 ffmpeg。
• 只有 image-gen 需要 API key（Gemini 或 OpenAI），从环境变量或 ~/.config/simcraft/keys.env 读取，密钥不应提交到仓库（image-gen）。
• 技能通过软链接安装而非打包分发，克隆目录需保持在链接时使用的路径。
• 仓库元数据未声明许可证，分发或整合前需先确认。

HotRepo 点评

在 2026-11-08 的新项目榜记录中，simcraft 有 114 stars 和 10 forks，统计窗口内约一小时内新增 14 stars 和 1 fork。目前只有这一条快照，说明的是短时间内的关注度，不足以判断趋势。它的实际价值在于技能覆盖面广且具体：视频渲染、仓库排查、基准测试方法等都配有真实脚本，而不只是提示词，与只写指令的提示词合集拉开了距离。