Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ruvnet avatar

Kg Traverse

  • 633 installs
  • 67k repo stars
  • Updated August 4, 2026
  • ruvnet/ruflo

kg-traverse is a Claude Code skill that performs pathfinder knowledge-graph traversal from a seed entity for developers who need precise retrieval across codebase and documentation context.

About

kg-traverse is an agent retrieval skill from ruvnet/ruflo that performs pathfinder graph traversal starting from a seed entity with an optional --depth limit. It expands outward through causal edges, scores paths by relevance, and prunes low-similarity branches using AgentDB MCP tools including hierarchical-recall, causal-edge, pattern-search, and context-synthesize. Developers reach for kg-traverse when they need to explore what depends on an entity, what it depends on, or discover indirect relationships across codebases, documentation, and project context. The skill reduces hallucination risk by grounding agent answers in graph-linked facts rather than isolated file snippets.

  • Traverses knowledge graphs built from repositories and docs
  • Enables structured retrieval for agentic workflows
  • Reduces hallucinations by grounding responses in graph relationships
  • Works with any MCP-compatible knowledge graph server
  • Supports complex multi-hop queries across entities and relations

Kg Traverse by the numbers

  • 633 all-time installs (skills.sh)
  • +10 installs in the week ending Jul 26, 2026 (Skillselion tracking)
  • Ranked #1,525 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill kg-traverse

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs633
repo stars67k
Last updatedAugust 4, 2026
Repositoryruvnet/ruflo

How do agents query knowledge graphs from a seed entity?

Query and navigate knowledge graphs created from codebases, documentation, and project context so agents can retrieve precise information instead of hallucinatin

Who is it for?

Developers building coding agents that must navigate large monorepos and documentation graphs without exhaustive file grepping.

Skip if: Simple keyword searches or projects without a prebuilt knowledge graph in AgentDB.

When should I use this skill?

An agent needs to explore dependencies, upstream causes, or indirect relationships starting from a named entity in the project knowledge graph.

What you get

Ranked traversal paths, pruned causal-edge chains, and synthesized context bundles from AgentDB graph queries.

  • Ranked traversal paths
  • Synthesized context from graph walk

Files

SKILL.mdMarkdownGitHub ↗

KG Traverse

Perform pathfinder graph traversal starting from a seed entity. Expands outward through causal edges, scores paths by relevance, and prunes low-similarity branches.

When to use

When you need to explore the knowledge graph starting from a specific entity -- finding what depends on it, what it depends on, or discovering indirect relationships. Useful for impact analysis, dependency chains, and understanding code structure.

Steps

1. Seed -- call mcp__claude-flow__agentdb_hierarchical-recall to look up the target entity by name 2. Expand -- call mcp__claude-flow__agentdb_causal-edge to find all edges connected to the seed entity, then recursively expand outward to the specified depth (default: 3) 3. Score -- for each path, compute relevance: cumulative_score = product(edge_weight * keyword_similarity(query, node)) using mcp__claude-flow__agentdb_pattern-search (the semanticRouter controller is enabled: false in current AgentDB builds; pattern-search is the available substitute and works fine for entity-name + relation-type keyword matches — see ruvnet/ruflo#2049). For higher-fidelity semantic similarity, callers can fall back to mcp__claude-flow__embeddings_generate + manual cosine, but that's not required for step 3 to function. 4. Prune -- remove paths with cumulative score below 0.3 5. Rank -- sort remaining paths by cumulative score descending 6. Synthesize -- call mcp__claude-flow__agentdb_context-synthesize to combine the top paths into a coherent summary 7. Report -- display the top 10 paths with: path (entity chain), relation types, cumulative score, and synthesized context

CLI alternative

npx @claude-flow/cli@latest memory search --query "relations for ENTITY_NAME" --namespace knowledge-graph

Related skills

How it compares

Use kg-traverse for multi-hop graph exploration from a seed entity; use flat memory search when you only need direct keyword matches.

FAQ

What MCP tools does kg-traverse use?

kg-traverse calls AgentDB MCP tools: agentdb_hierarchical-recall, agentdb_causal-edge, agentdb_pattern-search, and agentdb_context-synthesize, plus Bash for orchestration.

When should developers use kg-traverse?

kg-traverse fits when you need to explore the knowledge graph from a specific entity—finding dependents, upstream causes, or indirect relationships—with depth-controlled pathfinder traversal.

AI & Agent Buildingagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.