SOTA: counterfactual-causal skill graph for compact executable skill retrieval
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 4.5k
- Forks
- 603
- Avg merge
- 23h 32m
- Merged PRs (30d)
- 59
Description
Finding
CaSKG, arXiv:2608.25500, submitted 2026-08-26, treats skill retrieval as a causal graph calibration problem rather than independent vector similarity. It builds a high-recall directed candidate graph from semantic, lexical, input/output, and structural evidence, then uses direction-conditioned counterfactual probes that remove, substitute, and reorder skill pairs before publishing a state-filtered weighted graph. Across six LLMs, the originating team reports the best result in all 12 model/benchmark combinations: ScienceWorld macro average 72.62 to 80.50 and ALFWorld success 80.01% to 86.79%, with fewer mean environment steps. Code is public.
Evidence class: originating-team report with code, not independently reproduced by RuV.
Weighted Opportunity Score: 4.31/5.
Why this matters to PIR
PIR already has RuVector HNSW, graph, memory, Dream Machine evaluation, and skill/harness evolution work. The missing reusable primitive is calibrated directed dependency between skills. Pure nearest-neighbor retrieval can return individually relevant skills in the wrong procedural order or omit prerequisite and verification skills.
Proposed RuVector primitive
Add an experimental CausalSkillGraph above existing vector retrieval rather than replacing HNSW:
- HNSW provides high-recall candidate skills.
- Existing graph primitives store directed candidate edges.
- Edge evidence carries semantic, input/output, structural, repair, and counterfactual support.
- Edge confidence is Bayesian-smoothed and provenance-linked.
- Runtime expansion is filtered by current state from Core Memory or WorldGraph.
- Retrieval returns a compact ordered skill subgraph with prerequisites and verification steps.
No LLM-generated edge may become authoritative solely because a judge says it is causal. Counterfactual evidence and successful execution traces remain evidence; promotion is benchmark-gated.
Reuse
The same primitive can serve Dream Machine failure-localized skills, Ruflo agent skills, RuView procedures, MetaHarness generated capabilities, and LatentMesh protocol skills.
Benchmark
First reproduce one CaSKG condition with the public code and pinned commit. Then compare RuVector vector-only, naive graph expansion, and causal-calibrated expansion under identical models and task splits. Report success, steps, retrieval tokens, graph-build cost, counterfactual probe cost, edge precision, stale-edge behavior, and ablations.
Falsification
Reject if a simpler prerequisite schema matches the result, if graph construction cost dominates repeated use, if edges do not transfer across models or environments, or if state filtering creates brittle failures under missing state.
Acceptance
Require at least 5 absolute points task success improvement or 20% fewer environment/tool steps over the stronger existing RuVector retrieval baseline on held-out tasks, with retrieval context no larger than baseline, no protected-slice regression above 2 points, full edge provenance, and deterministic rollback to vector-only retrieval.
Related program: #837.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing one CaSKG condition with its public code and pinned commit. Then compare vector-only, naive graph, and causal-calibrated retrieval under identical models and task splits, measuring the metrics and ablations listed in the issue. Done means meeting the stated success or step-reduction threshold, preserving provenance and rollback, and passing the protected-slice and context-size constraints.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- ai, search
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100