Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

vector-setup — Claude Code skill: what it does, how to install

Bootstraps [email protected], installs missing add-ons, and registers the MCP server. Useful when /vector subcommands fail on missing dependencies.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add ruvnet/ruflo --skill vector-setup -a claude-code
Open on GitHub

What vector-setup does

The skill automates the first-run setup for [email protected] to prevent missing dependency errors across /vector subcommands. Without this bootstrap, commands fail when looking for ONNX WASM assets, @ruvector/pi-brain, or @ruvector/ruvllm.

Execution runs via Bash across set steps. It installs [email protected] and the missing packages. Passing --full also brings in @ruvector/graph-node and @ruvector/router. Afterward, it registers the MCP server through claude mcp add ruvector and validates the installation using doctor alongside smoke checks.

The native Rust toolchain is skipped because it is only necessary for source builds. On macOS arm64, the JS fallback inside @ruvector/ruvllm is sufficient, so native compilation for SONA is not required.

What it helps with

  • pin [email protected] and set up bundled ONNX WASM files
  • install missing @ruvector/pi-brain and @ruvector/ruvllm packages
  • register the ruvector MCP server in Claude Code
  • verify CLI health via ruvector doctor and smoke tests

Example prompts for the agent

  • Set up ruvector and install the core dependencies
  • Run vector-setup with the --full flag
  • Verify the ruvector install with doctor and register the MCP server

How to install vector-setup

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill vector-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/vector-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vector-setup/

From the same set104

The whole set →
ruflo ruvnet This skill adds multi-agent orchestration, memory, routing, and MCP tools to a project. Use it for swarm tasks and multi-step workflows. Claude Code CX Codex Cursor +1 4,000installs Swarm Orchestration ruvnet Skill for managing agent swarms with parallel execution, dynamic topology, and automatic load balancing. Use when a single agent is not enough and you need to orchestrate specialists of different types. Claude Code CX Codex Cursor +1 2,100installs github-project-management ruvnet Turns issue triage and board upkeep into gh and ruv-swarm calls: labels, subtasks, duplicate lookup. Useful when the tracker holds more tickets than order. Claude Code CX Codex Cursor +1 1,400installs github-workflow-automation ruvnet Automates GitHub Actions with AI agent coordination. Generates optimised pipelines, manages pull requests, analyzes failed runs, and deploys updates with risk assessment. Claude Code CX Codex Cursor +1 1,300installs github-code-review ruvnet Runs a swarm of specialized AI agents to inspect GitHub pull requests for security, performance, and architecture issues. Claude Code CX Codex Cursor +1 1,300installs stream-chain ruvnet Chains sequential agent steps together using streaming JSON flow and provides ready-to-run pipelines. Claude Code CX Codex Cursor +1 1,200installs flow-nexus-swarm ruvnet Deploy cloud-based AI agent swarms and define event-driven workflows with message queues. Use it to coordinate tasks, inspect runs, and scale a swarm. Claude Code CX Codex Cursor +1 1,200installs performance-analysis ruvnet Detects bottlenecks in Claude Flow swarms, profiles agent operations, and generates reports with actionable optimization recommendations. Claude Code CX Codex Cursor +1 1,200installs

Similar

cli-anything-inkscape HKUDS Stateful command-line interface skill for editing vector graphics in Inkscape, tracking project state in JSON, and manipulating SVG documents. Claude Code CX Codex Cursor +1 599installs godot-nodes-scenes gamedev-skills Teaches the agent to build a Godot 4.7 project from nodes and scenes: reusable .tscn files, runtime instancing, autoload singletons, and node lookups that survive renames. Claude Code CX Codex Cursor +1 6,200installs ce-explain EveryInc A skill that explains how a piece of code or a stretch of work ended up in its current shape, with the evidence it used. For the reasoning, not the recommendation. Claude Code CX Codex Cursor +1 952installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. Claude Code CX Codex Cursor +1 410,700installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. Claude Code CX Codex Cursor +1 410,300installs

Questions about vector-setup

How do I install vector-setup in Claude Code?

Run npx skills add ruvnet/ruflo --skill vector-setup -a claude-code in your terminal. The skill file will be placed in ~/.claude/skills/vector-setup/SKILL.md.

What does vector-setup do?

It resolves missing module errors for Brain, SONA, and ONNX subcommands. The skill installs the necessary npm packages in one step, configures the MCP server, and runs validation checks.

What does the --full flag add during setup?

Passing --full instructs the skill to pull @ruvector/graph-node and @ruvector/router in addition to @ruvector/pi-brain and @ruvector/ruvllm.

Source text

SKILL.md · MIT 
---
name: vector-setup
description: First-run setup for [email protected] — installs ONNX/Brain/SONA add-ons, registers the MCP server, and verifies the install via `doctor`
argument-hint: "[--full]"
allowed-tools: Bash Read
---

# Vector Setup

Bootstraps `[email protected]` and its optional add-ons so every `/vector` subcommand actually works on first run.

## Why this exists

Out of the box, several `/vector` subcommands fail with a confusing dep error:

| Error | Missing package |
|-------|-----------------|
| `ONNX WASM files not bundled. The onnx/ directory is missing.` | none — upgrade to ruvector 0.3.3, which bundles it (0.2.x lacks it) |
| `Brain commands require @ruvector/pi-brain` | `@ruvector/pi-brain` |
| `SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'` | `@ruvector/ruvllm` (JS fallback) |
| `LLM commands require @ruvector/ruvllm` | `@ruvector/ruvllm` |

This skill installs them in one pass.

## Steps

1. **Pin ruvector**:
   ```bash
   npm install [email protected]
   ```
2. **Install the add-ons** (idempotent — only what's missing):
   ```bash
   npm install @ruvector/pi-brain \
               @ruvector/ruvllm
   ```
   For a leaner install, pass `--full` to also pull `@ruvector/graph-node` and `@ruvector/router`:
   ```bash
   npm install @ruvector/pi-brain \
               @ruvector/ruvllm \
               @ruvector/graph-node \
               @ruvector/router
   ```
3. **Verify the binary**:
   ```bash
   npx -y [email protected] doctor
   npx -y [email protected] info
   ```
4. **Register the MCP server**:
   ```bash
   claude mcp add ruvector -- npx -y [email protected] mcp start
   claude mcp list | grep ruvector
   ```
5. **Sanity check** the most common subcommands:
   ```bash
   npx -y [email protected] hooks route "test"
   npx -y [email protected] attention list
   npx -y [email protected] rvf examples
   ```
6. **(Optional) Generate a pi identity** for brain + edge:
   ```bash
   npx -y [email protected] identity generate
   npx -y [email protected] identity show
   ```

## Smoke test

For a deterministic verification of the install, run the plugin's bundled smoke script:
```bash
bash plugins/ruflo-ruvector/scripts/smoke.sh
```

It checks: version pin, top-level subcommand visibility, `hooks ast-analyze`, `hooks route`, `attention list`, `rvf examples`, and `info`. Exits non-zero if any drift from the contracted surface is detected.

## What this does not install

- Native Rust toolchain (optional; only needed for source builds)
- Platform-specific native bindings (auto-detected by `@ruvector/core`)
- `@ruvector/sona` native binding (the JS fallback via `@ruvector/ruvllm` is sufficient on macOS arm64; Linux x64 has its own native binding)

If `doctor` still reports a problem after this skill runs, paste its output verbatim and ask.

© ruvnet · MIT · ruvnet/ruflo

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor