guide

Heart of Gold Toolkit

Don't Panic.

32 skills for AI coding agents. Five plugins. Works with Claude Code, Codex, OpenCode, Pi, and any tool supporting the agentskills.io standard. Named after The Hitchhiker's Guide to the Galaxy because the universe is absurd and your tools should at least have personality.

Installation

Claude Code

/plugin marketplace add ondrej-svec/heart-of-gold-toolkit
/plugin install deep-thought@heart-of-gold-toolkit

Codex

bunx @heart-of-gold/toolkit install --to codex

The Codex target also applies Codex-specific wording transforms for flagship shared skills so interactive flows like brainstorm and plan more strongly encourage Codex's structured user-input UI instead of falling back to plain text when richer selection UX is available. It also rewrites slash-command references in installed skill text — both plain (/plan, /work) and plugin-prefixed (/deep-thought:review, /marvin:compound) — to Codex-style $... skill invocations.

OpenCode

bunx @heart-of-gold/toolkit install --to opencode

Pi Coding Agent

# Option A: install the package directly in Pi to get skills + pi-native extensions
pi install npm:@heart-of-gold/toolkit

# Option B: install shared skills only into Pi's native skill directory
bunx @heart-of-gold/toolkit install --to pi

Important: choose one Pi install path or the other. Do not use both the Pi package install and install --to pi at the same time, or Pi will report duplicate skill collisions on reload.

The CLI now refuses install --to pi when your Pi settings already reference @heart-of-gold/toolkit as a package. If you intentionally want both paths for debugging, rerun with --force.

Pi also discovers skills from the shared ~/.agents/skills/ location, so installs done with the OpenCode target are usable from Pi too.

When installed as a Pi package, Heart of Gold exposes Pi-native extension commands for the flagship workflows:

• /deep-thought-brainstorm — start a brainstorm (collaborative discovery)
• /deep-thought-plan — start planning (research and produce a plan document)
• /deep-thought-architect — turn brainstorm decisions into stories and architecture docs
• /share-html — publish an HTML file or static site directory through the portable share-html skill
• /share-server-setup — set up or adopt the local share server through the portable share-server-setup skill
• /share-server-control — control the local share server lifecycle through the portable share-server-control skill
• /marvin-work — start executing a plan (with always-on safety guardrails)

Pi package installs also include a Pi-only guided workflow enhancer for supported Heart of Gold skills. For brainstorm, plan, and architect, when the assistant asks a high-confidence structured question, Pi can upgrade it into a custom interactive TUI and feed the answer back into the same workflow. Shared skills remain plain-text portable in every other harness.

For extension debugging, Pi also exposes /deep-thought-guided-debug to toggle notices explaining when a guided prompt was extracted, skipped, dismissed, or answered.

The skills themselves enforce their own boundaries (read-only for brainstorm/plan, safe commands for work) via allowed-tools and prompt constraints — no manual mode switching needed.

The work extension also provides always-on guardrails that protect .env, .git/, and node_modules/ from edits, block git add . and destructive rm, and require confirmation for git push / npm publish.

List available skills

bunx @heart-of-gold/toolkit list

Security & Trust

Some skills in this repository can, when configured by the user, interact with personal services and local tooling such as:

• Gmail and newsletter content
• iMessage or Slack notifications
• audio/image provider APIs
• external URLs discovered in newsletters or prompts

Treat skills and helper scripts as executable automation, not passive text. Review their contents before installing them, especially for plugins like Guide and Babel Fish that can access personal data or third-party services.

---

The Five Plugins

Deep Thought — The Answer Computer

Ten ways to think clearly about hard problems.

Brainstorm before you plan. Plan before you build. Investigate when something breaks. Review when it ships. Map where it could go when you can't see the futures yet. And when the stakes are high, simulate an expert panel that argues with itself until the right answer falls out.

10 skills · 9 agents · 16 knowledge files