Operations

/golem-install

Set up the golems ecosystem for the first time on a new machine. Checks CLI dependencies, wires MCP servers, creates skill symlinks. Use when: "set up golems", "install golems", "new machine setup", "wire skills". NOT for daily usage.

$ golems-cli skills install golem-install

Experimental

90% best pass rate

10 assertions

3 evals

6 workflows

Updated 2 weeks ago

First-time setup for the golems ecosystem on a new Mac. Checks deps, wires MCPs, symlinks skills.

Required CLIs

CLI	Purpose	Install
`gh`	GitHub — PRs, issues	`brew install gh`
`op`	1Password — secrets	`brew install 1password-cli`
`bun`	TypeScript runtime	`curl -fsSL https://bun.sh/install \| bash`
`cr`	CodeRabbit — code review	`brew install coderabbitai/tap/cr`
`git`	Version control	pre-installed on macOS
`jq`	JSON processing	`brew install jq`
`fswatch`	File watching	`brew install fswatch`

# Check all at once
for cmd in gh op bun cr git jq fswatch; do
  which $cmd >/dev/null 2>&1 && echo "✅ $cmd" || echo "❌ $cmd — needs install"
done

Skill Symlinks

Skills live in ~/Gits/golems/skills/golem-powers/. The symlink target depends on which CLI you use:

CLI	Skill directory
Claude Code	`~/.claude/commands/`
Codex	`~/.agents/skills/` (Codex reads from `~/.codex/skills/` → symlinked to `~/.agents/skills/`)
Cursor / Gemini	`~/.agents/skills/`

# For Claude Code
SKILLS_DIR=~/Gits/golems/skills/golem-powers
COMMANDS_DIR=~/.claude/commands
mkdir -p "$COMMANDS_DIR"
 
for skill_dir in "$SKILLS_DIR"/*/; do
  skill_name=$(basename "$skill_dir")
  ln -sf "$skill_dir" "$COMMANDS_DIR/$skill_name"
  echo "✅ Linked: $skill_name"
done
 
# For Codex / Cursor / Gemini
SKILLS_DIR=~/Gits/golems/skills/golem-powers
AGENTS_DIR=~/.agents/skills
mkdir -p "$AGENTS_DIR"
 
for skill_dir in "$SKILLS_DIR"/*/; do
  skill_name=$(basename "$skill_dir")
  ln -sf "$skill_dir" "$AGENTS_DIR/$skill_name"
  echo "✅ Linked: $skill_name"
done
# Then wire Codex to read from ~/.agents/skills/:
# ln -sf ~/.agents/skills/<skill> ~/.codex/skills/<skill>

Verify Claude Code: ls ~/.claude/commands/ should show ~45 skills. Verify Codex/other: ls ~/.agents/skills/ should show the installed skills.

MCP Servers

Wire these MCPs via ~/.mcp.json (at ~/Gits/ for cross-repo access):

MCP	Binary	Purpose
brainlayer	`brainlayer-mcp`	Memory search + store
voicelayer	`voicelayer-mcp`	TTS + STT
context7	`npx @upstash/context7-mcp`	Library docs
supabase	via config	Database

# Verify MCP binaries
which brainlayer-mcp || echo "Run: cd ~/Gits/brainlayer && bun link"
which voicelayer-mcp || echo "Run: cd ~/Gits/voicelayer && bun link"

Full SKILL.md source — includes LLM directives, anti-patterns, and technical instructions stripped from the Overview tab.

First-time setup for the golems ecosystem on a new Mac. Checks deps, wires MCPs, symlinks skills.

Required CLIs

CLI	Purpose	Install
`gh`	GitHub — PRs, issues	`brew install gh`
`op`	1Password — secrets	`brew install 1password-cli`
`bun`	TypeScript runtime	`curl -fsSL https://bun.sh/install \| bash`
`cr`	CodeRabbit — code review	`brew install coderabbitai/tap/cr`
`git`	Version control	pre-installed on macOS
`jq`	JSON processing	`brew install jq`
`fswatch`	File watching	`brew install fswatch`

# Check all at once
for cmd in gh op bun cr git jq fswatch; do
  which $cmd >/dev/null 2>&1 && echo "✅ $cmd" || echo "❌ $cmd — needs install"
done

Skill Symlinks

Skills live in ~/Gits/golems/skills/golem-powers/. The symlink target depends on which CLI you use:

CLI	Skill directory
Claude Code	`~/.claude/commands/`
Codex	`~/.agents/skills/` (Codex reads from `~/.codex/skills/` → symlinked to `~/.agents/skills/`)
Cursor / Gemini	`~/.agents/skills/`

# For Claude Code
SKILLS_DIR=~/Gits/golems/skills/golem-powers
COMMANDS_DIR=~/.claude/commands
mkdir -p "$COMMANDS_DIR"
 
for skill_dir in "$SKILLS_DIR"/*/; do
  skill_name=$(basename "$skill_dir")
  ln -sf "$skill_dir" "$COMMANDS_DIR/$skill_name"
  echo "✅ Linked: $skill_name"
done
 
# For Codex / Cursor / Gemini
SKILLS_DIR=~/Gits/golems/skills/golem-powers
AGENTS_DIR=~/.agents/skills
mkdir -p "$AGENTS_DIR"
 
for skill_dir in "$SKILLS_DIR"/*/; do
  skill_name=$(basename "$skill_dir")
  ln -sf "$skill_dir" "$AGENTS_DIR/$skill_name"
  echo "✅ Linked: $skill_name"
done
# Then wire Codex to read from ~/.agents/skills/:
# ln -sf ~/.agents/skills/<skill> ~/.codex/skills/<skill>

Verify Claude Code: ls ~/.claude/commands/ should show ~45 skills. Verify Codex/other: ls ~/.agents/skills/ should show the installed skills.

MCP Servers

Wire these MCPs via ~/.mcp.json (at ~/Gits/ for cross-repo access):

MCP	Binary	Purpose
brainlayer	`brainlayer-mcp`	Memory search + store
voicelayer	`voicelayer-mcp`	TTS + STT
context7	`npx @upstash/context7-mcp`	Library docs
supabase	via config	Database

# Verify MCP binaries
which brainlayer-mcp || echo "Run: cd ~/Gits/brainlayer && bun link"
which voicelayer-mcp || echo "Run: cd ~/Gits/voicelayer && bun link"

Global CLAUDE.md

Ensure ~/.claude/CLAUDE.md exists with global instructions. Template lives at:

~/Gits/orchestrator/standards/

1Password Items Needed

Item	Vault	Fields
`golems`	development	`context7.API_KEY`, `linear.API_KEY`
`ANTHROPIC`	development	`API_KEY`

# Verify 1Password access
op item get "golems" --vault development --fields label=context7.API_KEY 2>/dev/null && echo "✅ 1P connected" || echo "❌ 1P not connected"

Golem Terminal (Optional)

Native macOS terminal for running agents:

cd ~/Gits/golem-terminal && bash install.sh

Config lives at: ~/Library/Application Support/golem-terminal/golems.toml

Validation Checklist

echo "=== Golem Setup Validation ==="
echo "CLIs:"
for cmd in gh op bun cr git jq; do which $cmd >/dev/null 2>&1 && echo "  ✅ $cmd" || echo "  ❌ $cmd"; done
 
echo "Skills (Claude Code):"
skill_count=$(ls ~/.claude/commands/ 2>/dev/null | wc -l | tr -d ' ')
[ "$skill_count" -gt "30" ] && echo "  ✅ $skill_count skills linked in ~/.claude/commands/" || echo "  ❌ Only $skill_count skills in ~/.claude/commands/ (expected 40+)"
 
echo "Skills (Codex/other — ~/.agents/skills/):"
agents_count=$(ls ~/.agents/skills/ 2>/dev/null | wc -l | tr -d ' ')
[ "$agents_count" -gt "5" ] && echo "  ✅ $agents_count skills in ~/.agents/skills/" || echo "  ⚠️  Only $agents_count skills in ~/.agents/skills/ (run setup-symlinks for your CLI)"
 
echo "MCPs:"
which brainlayer-mcp >/dev/null 2>&1 && echo "  ✅ brainlayer-mcp" || echo "  ❌ brainlayer-mcp"
which voicelayer-mcp >/dev/null 2>&1 && echo "  ✅ voicelayer-mcp" || echo "  ❌ voicelayer-mcp"
 
echo "=== Done ==="

Troubleshooting

Homebrew not installed:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1Password CLI not connecting to app:

Open 1Password 8 desktop
Settings → Developer → Enable CLI integration
Enable biometric unlock for CLI

Skills not appearing in Claude Code:

ls ~/.claude/commands/
# Re-run the symlink step if empty or missing skills

Skills not appearing in Codex:

ls ~/.agents/skills/
ls ~/.codex/skills/  # Should symlink into ~/.agents/skills/
# Re-run: ln -sf ~/.agents/skills/<skill> ~/.codex/skills/<skill>

brainlayer-mcp not found:

cd ~/Gits/brainlayer && bun install && bun link

Experimental

Best Pass Rate

90%

Opus 4.6

Assertions

3 models tested

Avg Cost / Run

$0.2168

across models

Fastest (p50)

3.2s

Haiku 4.5

Behavior Evals

Phase 2 baseline — skill quality on Claude

Behavior Baseline

Opus 4.6

90%9/10

●

Sonnet 4.6

90%9/10

●

Haiku 4.5

60%6/10

◓

Assertion	Opus 4.6	Sonnet 4.6	Haiku 4.5	Consensus
verifies-deps-before-install				3/3
creates-skill-symlinks				2/3
wires-mcp-servers				2/3
runs-validation-checklist				3/3
checks-existing-symlinks				2/3
symlinks-from-correct-source				3/3
verifies-skill-count				2/3
checks-all-seven-clis				2/3
checks-mcp-binaries				2/3
reports-specific-failures				3/3

Token Usage

Opus 4.6

13,072

Sonnet 4.6

3,708

Haiku 4.5

2,694

Input tokensOutput tokens

Cost per Run

Opus 4.6

$0.6197

Sonnet 4.6

$0.0290

Haiku 4.5

$0.0018

Model	Input Tokens	Output Tokens	Cost / Run	Cost / 1K Runs
Opus 4.6	6,012	7,060	$0.6197	$619.70
Sonnet 4.6	2,219	1,489	$0.0290	$29.00
Haiku 4.5	1,550	1,144	$0.0018	$1.80

Response Time (p50)

Haiku 4.5

3.2s

Sonnet 4.6

5.8s

Opus 4.6

8.1s

Response Time (p95)

Haiku 4.5

5.4s

Sonnet 4.6

9.0s

Opus 4.6

15.2s

Model	p50	p95	Overhead
Opus 4.6	8.1s	15.2s	+87%
Sonnet 4.6	5.8s	9.0s	+56%
Haiku 4.5	3.2s	5.4s	+69%

Last evaluated: 2026-03-12 · Data is generated from skill assertions (real cross-model benchmarks coming soon)

Workflows

/golem-install:setup-tokens/golem-install:validate/golem-install:setup-symlinks/golem-install:check-deps/golem-install:install-deps/golem-install:wire-project

Quick Install

golems-cli skills install golem-install

Or paste into Claude Code:

Install and configure the golem-install skill for Claude Code.
Download from github.com/EtanHey/golems/tree/master/skills/golem-powers/golem-install
and symlink to ~/.claude/commands/golem-install/. If ~/.golems/config.yaml
doesn't exist, run the setup wizard first. Then follow the First-Time
Setup section in the SKILL.md.

Grade: Experimental
Category: Operations
Evals: 3
Assertions: 10 passing
Fixtures: None
Workflows: 6
Updated: 2 weeks ago

View source on GitHub

Related Skills

/cmux-agents

Spawn AI agents in cmux panes — Claude workers as splits, audits/research as sur...

/1password

Use when managing secrets, credentials, API keys, or vault operations. Supports ...

/convex

Use when working with Convex backend - dev server, deployment, function executio...