zdstudios/aios/vector-hyperbolic

Claude Code and agent skill by zdstudios/aios

Trust tier 3
  • community
Source check pending

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

Embed hierarchical data via npx ruvector@0.2.25 embed text and project into the Poincare ball in user code (no --model poincare flag in 0.2.25)

Install

npx vskill@latest install zdstudios/aios/vector-hyperbolic

SKILL.md

The same SKILL.md was published earlier as zdstudios/aios/vector-hyperbolic.

Vector Hyperbolic

Embed hierarchical data in the Poincare ball model using ruvector.

When to use

Use this skill when your data has inherent hierarchy — dependency trees, module structures, taxonomies, org charts, ontologies. Hyperbolic space captures hierarchical distances with far fewer dimensions than Euclidean embeddings.

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 ``

  1. Generate a base ONNX embedding (ruvector@0.2.25 does not expose a --model poincare flag on embed text):

``bash npx -y ruvector@0.2.25 embed text "hierarchical concept" -o concept.vec.json ``

  1. Project into the Poincare ball in your own code (or via the experimental neural substrate):

``bash npx -y ruvector@0.2.25 embed neural --help ` For an ad-hoc projection, normalize the 384-dim vector to live inside the unit ball (x_i / (||x|| * (1 + epsilon))`) and persist the projected coordinates alongside the original embedding.

  1. Geodesic distance: d(u, v) = arcosh(1 + 2 * ||u-v||^2 / ((1-||u||^2)(1-||v||^2)))

Distance grows logarithmically with tree depth, preserving hierarchy.

  1. Store results:

mcp__plugin_ruflo-core_ruflo__memory_store({ key: "hyperbolic-CONCEPT", value: "COORDINATES_AND_NEIGHBORS", namespace: "hyperbolic-embeddings" })

Caveats

  • ruvector@0.2.25 has no first-class Poincare ball CLI flag. Treat hyperbolic projection as a post-processing step over a standard ONNX embedding.
  • If you need a hyperbolic search index, store projected coordinates in AgentDB and compute geodesic distance in your own retrieval code.

Poincare ball properties

PropertyMeaning
Norm close to 0Generic, root-level concept
Norm close to 1Specific, leaf-level concept
Small geodesic distanceClosely related in hierarchy
Large geodesic distanceDistant or different subtrees

Use cases

  • Dependency analysis: embed module imports to find tightly coupled subtrees
  • Code architecture: map class hierarchies to discover structural patterns
  • Knowledge organization: embed concepts to reveal taxonomic relationships
  • Codebase navigation: find most specific/general modules relative to a query

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

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

Source

Popularity

Repository stars
4
7-day trend score
13

Stars and forks are for the whole GitHub repository, not this skill alone. 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/zdstudios/aios/vector-hyperbolic/badge)](https://verified-skill.com/skills/zdstudios/aios/vector-hyperbolic)

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