Skip to content
cccskills
FreePublished on GitHub

agentdb-causal-link

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.

See how to install

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Link Causally

Add a typed edge between two memories so future queries can traverse cause→effect, supersedes, depends-on, etc.

When to use

  • User says "X caused Y", "this depends on that", "this supersedes the old one"
  • Post-incident analysis — recording what led to what
  • Building a knowledge graph from a sequence of episodes
  • ADR housekeeping — supersedes / amends / related-to between architecture decisions

API

agentdb_causal_edge(
  fromMemoryId:   <id>
  fromMemoryType: 'episode' | 'pattern' | 'skill' | 'adr'
  toMemoryId:     <id>
  toMemoryType:   <same set>
  relation:       'caused' | 'supersedes' | 'depends-on' | 'related-to' | <custom>
  similarity?:    0..1
  uplift?:        -1..1   // signed reward delta
  confidence?:    0..1
  metadata?:      { evidenceCount, sourceTimestamp, ... }
)

uplift is the secret sauce. Positive uplift = the causal link improved outcomes; negative = it hurt. The agentdb-investigator agent (this plugin) walks edges weighted by uplift × confidence to find root causes.

Cascade-aware delete

The agentdb 3.0.0-alpha.13 release added cascade: true semantics:

  • agentdb_causal_edge_delete(edgeId) — single edge
  • agentdb_causal_node_delete(nodeId, { cascade: true }) — node + all incident edges; returns deletedEdges count
  • agentdb_edges_by_endpoints(from, to, label?) — bulk delete by tuple

Use cascade when removing an obsolete ADR or decommissioning an agent — leaving dangling edges in the graph poisons future traversals.

Don't

  • Don't link memories without confidence < 0.5 unless you mark them as conjectures. Low-confidence edges accumulate and degrade agentdb_causal_explain quality.
  • Don't use caused for correlation — reserve it for genuinely causal evidence (controlled change, repeated observation, expert confirmation).
  • Don't forget the inverse direction. "A supersedes B" implies B is no longer authoritative; tag B's hierarchical entry as deprecated in the same operation.

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

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.

ruvnet/agentdb93Updated Oct 12, 2026

See all skills by ruvnet

Report a problem with this skill