harleycoops/math-to-manim-ch/hermes-learns-manim

Hermes 学习 Manim

当用 Hermes 操作 Math-To-Manim repo 来检查、生成、验证、渲染或审阅教育 Manim animations 时，使用这个 skill。

Operating Contract

• 编辑前阅读 README.md 和 AGENTS.md。
• 把 Hermes 视为 contributor tooling，而不是 Python runtime dependency。
• 保持 M2M2 artifacts 在 runs/<run_id>/ 下可检查。
• 保留 pipeline contract：story before symbols、geometry before algebra、artifacts before side effects。
• 在 model-backed 或 render-heavy runs 前，优先使用 deterministic no-render checks。
• 不要 commit generated runs/、media/、temporary renders、secrets 或 local caches。
• 对 showcase/media changes，声称成功前要 visually inspect representative frames/GIFs。

Quick Verification

从 repo root 运行：

./.venv/bin/python -m math_to_manim.cli --help
./.venv/bin/python -m math_to_manim.cli generate --help
./.venv/bin/python -m math_to_manim.cli generate "Explain why derivatives are slopes" --deterministic --no-render --runs-dir /tmp/m2m2-smoke

如果 venv 尚未安装：

python3 -m venv .venv
./.venv/bin/python -m pip install -U pip
./.venv/bin/python -m pip install -e ".[dev]"

对 Codex-backed code generation，先验证本地 Codex CLI：

codex --version
codex exec "Say ready from inside this repo"

Starter Workflow

1. 检查 pyproject.toml、math_to_manim/cli.py 和 math_to_manim/pipeline/runner.py。
2. 修改行为前运行 CLI help 或 deterministic smoke command。
3. 打开生成的 runs/<run_id>/ bundle，先检查 JSON artifacts，再修改 downstream code。
4. 对 media work，只有 static validation 通过后才 render，并 visually inspect output。
5. 报告 exact commands、run bundle paths、skipped checks 和 changed files。

Hermes Registration

注册 parent skills directory，而不是这个 skill directory 本身：

hermes config set skills.external_dirs "$(pwd)/hermes/skills"
hermes skills list --source local
hermes --skills hermes-learns-manim,agents-md,codebase-inspection,manim-video,systematic-debugging

Hermes 会递归扫描 configured external skill directories 中的 SKILL.md files。把 skills.external_dirs 指向 hermes/skills 后，hermes-learns-manim 就能按名称发现。

完整 repo instructions 见 README.md 和 AGENTS.md。