HEAT · Climate & Cooling Engineering Knowledge brief · 2026-05-24 · INDIA squad

Polyskill — Cross-runtime HEAT skill bridge

Source: 00-SYSTEMS/polyskill/ · 5 scripts + README · HEAT internal use
01 · Problem framing

149 skills × 4 runtimes = drift surface

before — drift after — bridge Claude Code v3.1 Codex v2.8 Gemini v3.0 Hermes v2.4 ~/knowledge-base/ .claude/skills/<name>.md v3.1 — sole truth edited once 4 runtimes read it via symlinks · MCP bridge

Maintaining the same procedure in four runtime folders meant constant version drift and silent bugs.

Recommendation: edit only the canonical KB file; never touch runtime copies.
02 · Distribution layout

Symlinks + MCP, not copies

~/knowledge-base/.claude/skills/<name>.md canonical Claude Code ~/.claude/skills/ + /commands/ Codex desktop via marketplace plugin Gemini ~/.gemini/ antigravity Hermes MCP — live read no copy needed

Each runtime reads the canonical file via a symlink; Hermes reads it live over MCP.

Recommendation: never copy skills — only symlink. Edits propagate atomically.
03 · The bridge script

bootstrap-cross-runtime.sh <name>

bootstrap-cross-runtime.sh <skill-stem> claude skill + command codex skill + dispatch gemini antigravity hermes no-op idempotent · ~ 200 ms preserves any real files; only symlinks empty slots bulk loop available: bootstrap-all-skills.sh runs 149 skills in < 1 second

One script writes symlinks and slash-command wrappers; safe to re-run; preserves real files.

Recommendation: run once per skill, or loop the whole library — same result.
04 · Auto-bridge for new skills

Three triggers, zero manual steps

write new-skill.md A launchd watcher 10 s throttle D /skill-creator post-save hook C Mon 06:20 — safety net three triggers always bridged

Filesystem watcher (A), skill-creator hook (D), and weekly sweep (C) cover every authoring path.

Recommendation: install with install-polyskill-launchd.sh — one shot, set-and-forget.
05 · Heatie onboarding

5 commands · ~ 3 minutes · once per Mac

1 git pull ~ 30 s 2 install polyskill ~ 45 s 3 codex marketplace ~ 10 s 4 bulk bootstrap ~ 60 s 5 launchd auto ~ 5 s restart Claude Code + Codex app · test /image-sketch-html --source "test"

Five scripted commands, plus one app restart; future skills bridge themselves via launchd.

Recommendation: ship to BACs first (5 BACs · done), then knowbase-ch broadcast.