hdresearch/reef/setup
Claude Code and agent skill by hdresearch/reef
- community
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/setupSKILL.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
| Service | What it does | |
|---|---|---|
| board | Task tracking with review workflow, notes, artifacts, priority bumps | |
| feed | Activity event stream with SSE, auto-publishes from board events | |
| log | Append-only work log with time-range queries | |
| journal | Personal narrative log with mood/vibe tagging | |
| commits | VM snapshot ledger for tracking golden images | |
| reports | Markdown reports with title, author, tags | |
| usage | Cost & token tracking with per-agent summaries (depends on feed) | |
| updater | Auto-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:
Then restart or reload:
Install a Subset
Pick what you need. A minimal coordination setup:
Reload:
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:
Run this to fix all imports at once after copying:
On Linux (no -i ''):
Verify
After copying and fixing imports:
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:
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/toservices/ - [ ] 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 /docsshows 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
- SKILL.md in the repositoryCheckingskills/setup/SKILL.md
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
[](https://verified-skill.com/skills/hdresearch/reef/setup)