New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Vector Cluster

by ruvnet in ruvnet/ruflo

Cluster code by graph community detection via npx ruvector@0.2.25 hooks graph-cluster (spectral / Louvain)

MITAuto-check: notes

Install Vector Cluster

skills CLI
$ npx skills add ruvnet/ruflo --skill vector-cluster -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/ruflo vector-cluster --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-ruvector/skills/vector-cluster .claude/skills/vector-cluster && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vector-cluster
GitHub stars
74k
Token cost
~540 tokens
SKILL.md length
196 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Cluster code by graph community detection via npx ruvector@0.2.25 hooks graph-cluster (spectral / Louvain)

  • Works in 4 steps: Ensure ruvector@0.2.25 is available → Run clustering — in ruvector@0.2.25 the… → Review output — JSON with cluster… → …
  • SKILL.md covers When to use, Steps, Interpreting results and Caveats
  • Calls npm and npx

What it does

Vector Cluster is an agent skill from ruvnet/ruflo. Cluster code by graph community detection via npx ruvector@0.2.25 hooks graph-cluster (spectral / Louvain)

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

Example prompts

  • “/vector-cluster”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_list

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Ensure ruvector@0.2.25 is available
  2. Run clustering — in ruvector@0.2.25 the only working clustering is via hooks graph-cluster (spectral/Louvain over a code graph). The…
  3. Review output — JSON with cluster assignments, community labels, and edges. If you see "graph.nodes is not iterable", run hooks init first…
  4. Store results

What it can do on your machine

Read from SKILL.md and the folder at commit de590e1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • mcp__plugin_ruflo-core_ruflo__memory_search
    • mcp__plugin_ruflo-core_ruflo__memory_store
    • mcp__plugin_ruflo-core_ruflo__memory_list

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vector Cluster loads about 540 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~540

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_store,

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit de590e1, republished under its MIT licence (© ruvnet). 196 words, ~540 tokens.

Download SKILL.mdSave it as .claude/skills/vector-cluster/SKILL.md (or your agent's skills folder).
name
vector-cluster
description
Cluster code by graph community detection via npx ruvector@0.2.25 hooks graph-cluster (spectral / Louvain)
allowed-tools
Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_list
argument-hint
<namespace> [--k N]

Vector Cluster

Cluster vectors in a namespace by semantic similarity using ruvector.

When to use

Use this skill when you have a collection of embeddings and want to discover natural groupings. Clustering reveals themes, identifies outliers, and helps organize large vector collections.

Steps

  1. Ensure ruvector@0.2.25 is available:
    bash
    npm ls ruvector 2>/dev/null | grep '0.2.25' || npm install ruvector@0.2.25
  2. Run clustering — in ruvector@0.2.25 the only working clustering is via hooks graph-cluster (spectral/Louvain over a code graph). The top-level cluster command is reserved for distributed cluster ops and is currently "Coming Soon" upstream.
    bash
    npx -y ruvector@0.2.25 hooks graph-cluster <files...>
npx -y ruvector@0.2.25 hooks graph-mincut <files...>
  3. Review output — JSON with cluster assignments, community labels, and edges. If you see "graph.nodes is not iterable", run hooks init first to seed the graph state.
  4. Store results: mcp__plugin_ruflo-core_ruflo__memory_store({ key: "clusters-PROJECT-TIMESTAMP", value: "CLUSTER_ASSIGNMENTS", namespace: "vector-clusters" })

Interpreting results

  • High cohesion (>0.85): tight, well-defined cluster
  • Medium cohesion (0.6-0.85): related but diverse content
  • Low cohesion (<0.6): loose grouping, try higher resolution
  • Outliers: novel or anomalous files worth investigating

Caveats

  • cluster --namespace ... --k N and cluster --density are not valid in ruvector@0.2.25 — those flags fall through to the distributed-cluster command, which only accepts --status, --join, --leave, --nodes, --leader, --info.
  • For namespaced k-means over arbitrary embeddings, run k-means in your own code against vectors stored in AgentDB.

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/ruflo-ruvector/skills/vector-cluster of ruvnet/ruflo.

Open the folder on GitHubat commit de590e1

Compare with similar skills

Vector Cluster next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vector Cluster compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vector Cluster this skillruvnet/ruflo74k—~540Automated safety check: NotesMIT
Graphagenticnotetaking/arscontexta3.5k1 repos~4.9kAutomated safety check: NotesMIT
Bigquery Graphgoogle/adk-python22k—~4.8kAutomated safety check: PassApache-2.0
Hunt RAG Vectorsickn33/agentic-awesome-skills47k1 repos~3kAutomated safety check: PassMIT
Code Review Graph Buildertirth8205/code-review-graph32k—~295Automated safety check: PassMIT
Vector DBRightNow-AI/openfang18k—~1kAutomated safety check: PassApache-2.0

Similar skills

  • Graph

    agenticnotetaking/arscontexta

    Interactive knowledge graph analysis. An agent skill from agenticnotetaking/arscontexta.

    3.5k GitHub starsUsed in 1 repo~4.9k tokens
    Knowledge ManagementAuto-check: notes

  • Bigquery Graph

    google/adk-python

    Official

    Skill for Graph Query Language (GQL) or SQL/PGQ queries against a property graph.

    22k GitHub stars~4.8k tokensUpdated today
    DatabasesAuto-check passed

  • Hunt RAG Vector

    sickn33/agentic-awesome-skills

    Hunt vector-store / embedding-layer weaknesses in RAG pipelines (OWASP LLM08 Vector and Embedding Weaknesses)

    47k GitHub starsUsed in 1 repo~3k tokens
    AI & LLM EngineeringAuto-check passed

  • Code Review Graph Builder

    tirth8205/code-review-graph

    Builds or incrementally updates the code-review knowledge graph for a repository and reports whether the build succeeded, partly or failed.

    32k GitHub stars~295 tokensUpdated today
    DevelopmentAuto-check passed

  • Vector DB

    RightNow-AI/openfang

    Vector database expert for embeddings, similarity search, RAG patterns, and indexing strategies

    18k GitHub stars~1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed

  • Mini Context Graph

    github/awesome-copilot

    Official

    A persistent, compounding knowledge base combining Karpathy's LLM Wiki pattern with a structured knowledge graph.

    40k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo

  • AgentDB Pattern Memory

    ruvnet/ruflo

    Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed

  • Security Audit Scanner

    ruvnet/ruflo

    Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed

  • SPARC Development Methodology

    ruvnet/ruflo

    Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed

  • Swarm Orchestration

    ruvnet/ruflo

    Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed

  • Ruflo Multi-Agent Orchestration

    ruvnet/ruflo

    Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed

  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Questions about Vector Cluster

What does Vector Cluster do?

Cluster code by graph community detection via npx ruvector@0.2.25 hooks graph-cluster (spectral / Louvain). Vector Cluster is an agent skill from ruvnet/ruflo.

How do I install Vector Cluster in Claude Code?

Run `npx skills add ruvnet/ruflo --skill vector-cluster -a claude-code`. Or copy the skill folder (plugins/ruflo-ruvector/skills/vector-cluster in ruvnet/ruflo) into .claude/skills/vector-cluster in your project. Claude Code loads it when a task matches its description.

How do I install Vector Cluster in Codex?

Run `npx skills add ruvnet/ruflo --skill vector-cluster -a codex`. Or copy the skill folder (plugins/ruflo-ruvector/skills/vector-cluster in ruvnet/ruflo) into .agents/skills/vector-cluster in your project. Codex loads it when a task matches its description.

Can I use Vector Cluster in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill vector-cluster -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vector-cluster, .gemini/skills/vector-cluster, .github/skills/vector-cluster and .opencode/skills/vector-cluster in your project.

What does Vector Cluster need to run?

Going by SKILL.md and its folder, Vector Cluster needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_list.

Does Vector Cluster access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Vector Cluster safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Vector Cluster use?

Vector Cluster is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vector Cluster use?

About 540 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vector Cluster?

Skills that share tags, products or a category with Vector Cluster: Graph (agenticnotetaking/arscontexta, 3.5k stars), Bigquery Graph (google/adk-python, 22k stars), Hunt RAG Vector (sickn33/agentic-awesome-skills, 47k stars) and Code Review Graph Builder (tirth8205/code-review-graph, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vector Cluster?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,012 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 7, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.