Skip to content
cccskills
FreePublished on GitHub

agentdb-causal-explain

Walk the causal graph in AgentDB to explain why two memories are connected, or trace a root cause. Use when the user asks "why did X happen", "what led to Y", or after an incident.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Causal Explain

Given a target memory (an episode, a failed test, an outgoing change), traverse the causal graph backwards through edges to surface the chain of preceding events that explain it.

When to use

  • "Why did this fail?"
  • "What led to the regression?"
  • "Trace the dependency chain for X."
  • Incident postmortem — surface every step + decision that contributed.

API

agentdb_causal_explain(
  targetMemoryId:  <id>
  maxDepth?:       3
  minConfidence?:  0.5
  edgeWeights?:    'uplift' | 'confidence' | 'product'   // ranking strategy
)

Returns a path or DAG of (node, edge, node) tuples ranked by combined confidence × |uplift|. Each step carries the relation (caused, supersedes, depends-on, etc.) so the explanation reads naturally.

Output shape

Why did "deploy-2026-05-04 failed migration" happen?

  ┌─ skill[migrate-add-not-null-column]   confidence 0.92
  │     ─[supersedes]→ skill[v1: migrate-with-default]
  │     ─[caused]→     episode[long-running migration on 50M rows]
  │                          ─[caused]→ episode[deploy-2026-05-04 failed migration]
  │
  └─ adr[ADR-046: zero-downtime migration policy]   confidence 0.78
        ─[depends-on]→ skill[migrate-add-not-null-column]

Use the investigator agent

For complex traces, dispatch the agentdb-investigator agent (this plugin) — it walks deeper, cross-references with hierarchical memory, and writes a postmortem-shaped report.

Don't

  • Don't traverse with maxDepth > 5 casually — graph fan-out gets exponential and the bandit's confidence weights don't compensate.
  • Don't ignore the confidence column. A high-uplift edge with confidence 0.3 is gossip, not evidence.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Master advanced AgentDB features including QUIC synchronization, multi-database management, custom distance metrics, hybrid search, and distributed systems integration. Use when building distributed AI systems, multi-agent coordination, or advanced vector search applications.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

Create and train AI learning plugins with AgentDB's 9 reinforcement learning algorithms. Includes Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more. Use when building self-learning agents, implementing RL, or optimizing agent behavior through experience.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

Implement persistent memory patterns for AI agents using AgentDB. Includes session memory, long-term storage, pattern learning, and context management. Use when building stateful agents, chat systems, or intelligent assistants.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

Optimize AgentDB performance with quantization (4-32x memory reduction), HNSW indexing (150x faster search), caching, and batch operations. Use when optimizing memory usage, improving search speed, or scaling to millions of vectors.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

Implement semantic vector search with AgentDB for intelligent document retrieval, similarity matching, and context-aware querying. Use when building RAG systems, semantic search engines, or intelligent knowledge bases.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

Record a causal relationship between two memories in AgentDB — "X caused Y", "A supersedes B", "patch-foo depends-on patch-bar". Use when the user is documenting cause/effect, dependencies, supersessions, or after-action analysis.

The English summary is being prepared. Showing the original description.

ruvnet/agentdb93Updated Oct 12, 2026

See all skills by ruvnet

Report a problem with this skill