hdresearch/reef/setup

Claude Code and agent skill by hdresearch/reef

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Set up a reef server with example services. Use when bootstrapping a new reef instance or adding fleet coordination services to an existing one.

Install

npx vskill@latest install hdresearch/reef/setup

SKILL.md

The same SKILL.md was published earlier as hdresearch/reef/setup.

Setup Reef

Reef ships with core infrastructure services in services/ (including vm-tree, signals, swarm, lieutenant, usage, probe, docs, installer, services, store, cron, ui). Optional example services live in examples/services/ and can be copied into services/ if you want them.

Available Example Services

ServiceWhat it does
boardTask tracking with review workflow, notes, artifacts, priority bumps
feedActivity event stream with SSE, auto-publishes from board events
logAppend-only work log with time-range queries
journalPersonal narrative log with mood/vibe tagging
commitsVM snapshot ledger for tracking golden images
reportsMarkdown reports with title, author, tags
usageCost & token tracking with per-agent summaries (depends on feed)
updaterAuto-update reef from npm

Dependencies

Some services depend on others. Install dependencies first:

  • usage depends on feed
  • ui is a core service; works best with board and feed (for panels)

Install All Example Services

To install everything:

bash
cp -r examples/services/feed services/feed
cp -r examples/services/board services/board
cp -r examples/services/log services/log
cp -r examples/services/journal services/journal
cp -r examples/services/commits services/commits
cp -r examples/services/reports services/reports
cp -r examples/services/usage services/usage
cp -r examples/services/updater services/updater

Then restart or reload:

bash
curl -X POST http://localhost:3000/services/reload -H "Authorization: Bearer $TOKEN"

Install a Subset

Pick what you need. A minimal coordination setup:

bash
# Task tracking + activity feed
cp -r examples/services/feed services/feed
cp -r examples/services/board services/board
# Work log
cp -r examples/services/log services/log
# Web dashboard is built-in at services/ui — no copy needed

Reload:

bash
curl -X POST http://localhost:3000/services/reload -H "Authorization: Bearer $TOKEN"

Fix Import Paths

The example services import types from ../src/core/types.js (relative to examples/services/). After copying to services/, the import path resolves to services/src/core/types.js which doesn't exist.

You must fix the imports in each copied service. Change:

ts
// Before (in examples/services/)
import type { ServiceModule } from "../src/core/types.js";
ts
// After (in services/)
import type { ServiceModule } from "../../src/core/types.js";

Run this to fix all imports at once after copying:

bash
find services/ -name '*.ts' -exec sed -i '' 's|from "../src/core/|from "../../src/core/|g' {} +
find services/ -name '*.ts' -exec sed -i '' 's|from "\.\./src/core/|from "../../src/core/|g' {} +

On Linux (no -i ''):

bash
find services/ -name '*.ts' -exec sed -i 's|from "../src/core/|from "../../src/core/|g' {} +

Verify

After copying and fixing imports:

bash
# Check the server starts
bun run start
# Or check health
curl http://localhost:3000/health

The health endpoint lists all loaded services. Every service you copied should appear.

Runtime Install (Alternative)

Instead of copying, you can use the installer to symlink from examples:

bash
curl -X POST http://localhost:3000/installer/install \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"source": "./examples/services/board"}'

This creates a symlink — changes to the example source are reflected immediately. Good for development, but the import path issue still applies if examples use relative paths to src/core/.

Checklist

  • [ ] Copied the services you need from examples/services/ to services/
  • [ ] Installed dependencies first (feed before usage)
  • [ ] Fixed import paths (../src/core/ → ../../src/core/)
  • [ ] Server starts without errors
  • [ ] All copied services appear in GET /health
  • [ ] GET /docs shows routes for each new service

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/hdresearch/reef/setup/badge)](https://verified-skill.com/skills/hdresearch/reef/setup)

Something wrong with this skill or its page? Tell us.