zdstudios/aios/vector-hyperbolic
Claude Code and agent skill by zdstudios/aios
- community
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-hyperbolicSKILL.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
- Ensure ruvector@0.2.25 is available:
``bash npm ls ruvector 2>/dev/null | grep '0.2.25' || npm install ruvector@0.2.25 ``
- Generate a base ONNX embedding (ruvector@0.2.25 does not expose a
--model poincareflag onembed text):
``bash npx -y ruvector@0.2.25 embed text "hierarchical concept" -o concept.vec.json ``
- 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.
- 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.
- 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
| Property | Meaning | |
|---|---|---|
| Norm close to 0 | Generic, root-level concept | |
| Norm close to 1 | Specific, leaf-level concept | |
| Small geodesic distance | Closely related in hierarchy | |
| Large geodesic distance | Distant 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
- SKILL.md in the repositoryCheckingruflo-main/plugins/ruflo-ruvector/skills/vector-hyperbolic/SKILL.md
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
[](https://verified-skill.com/skills/zdstudios/aios/vector-hyperbolic)