Papers › Skill-RAG: Failure-State-Aware Retrieval Augmentation via Hidden-State Probing and...

Skill-RAG: Failure-State-Aware Retrieval Augmentation via Hidden-State Probing and Skill Routing

17 Apr 2026arXiv:2604.15771added by Syntology

Kai Wei, Raymond Li, Xi Zhu, Zhaoqian Xue, Jiaojiao Han, Jingcheng Niu, Fan Yang

Title, abstract, authors and date from arXiv's metadata (CC0); this paper is not in the Papers with Code archive (frozen 2025-07-28).

Retrieval-Augmented Generation (RAG) has emerged as a foundational paradigm for grounding large language models in external knowledge. While adaptive retrieval mechanisms have improved retrieval efficiency, existing approaches treat post-retrieval failure as a signal to retry rather than to diagnose -- leaving the structural causes of query-evidence misalignment unaddressed. We observe that a significant portion of persistent retrieval failures stem not from the absence of relevant evidence but from an alignment gap between the query and the evidence space. We propose Skill-RAG, a failure-aware RAG framework that couples a lightweight hidden-state prober with a prompt-based skill router. The prober gates retrieval at two pipeline stages; upon detecting a failure state, the skill router diagnoses the underlying cause and selects among four retrieval skills -- query rewriting, question decomposition, evidence focusing, and an exit skill for truly irreducible cases -- to correct misalignment before the next generation attempt. Experiments across multiple open-domain QA and complex reasoning benchmarks show that Skill-RAG substantially improves accuracy on hard cases persisting after multi-turn retrieval, with particularly strong gains on out-of-distribution datasets. Representation-space analyses further reveal that the proposed skills occupy structured, separable regions of the failure state space, supporting the view that query-evidence misalignment is a typed rather than monolithic phenomenon.

PaperPDFCode Syntology ran

In Syntology Open this paper in Syntology's Atlas, the map of the papers in Syntology's graph and their citations.

For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2604.15771")

Code

Syntology Ran 0 of 13 code samples harvested from 1 repository linked to this paper; 13 have no recorded run.

By repository: found in paper text by Syntology: 13 samples from 1 repository, 0 ran. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

weikai202/SkillRAG found in paper text by Syntology report

Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

13 samples harvested; 0 ran; 0 honoured the contract we drafted; 13 have no recorded run. Read from Syntology's graph 2026-09-24; that is when this build read the record, not when the samples ran.

13unverified

Licence: 13 of the 13 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from weikai202/SkillRAG. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

collect_metrics weikai202/SkillRAG/collect_build_metrics.py found in paper text by Syntology unverified no licence file found · pointer only · dd17eaa0063424a5 · report
exp_rag_cmd weikai202/SkillRAG/quick_check_qwen_skillrag_demo.py found in paper text by Syntology unverified no licence file found · pointer only · e17a54f7dd2bcdcd · report
expected_post_ckpt_paths weikai202/SkillRAG/check_prober_ckpt.py found in paper text by Syntology unverified no licence file found · pointer only · 765f888c312c867e · report
extract_records_from_pt weikai202/SkillRAG/analyze_hiddenstate_clusters.py found in paper text by Syntology unverified no licence file found · pointer only · 9844757f9ddf19d9 · report
get_paths weikai202/SkillRAG/balance_train_dataset.py found in paper text by Syntology unverified no licence file found · pointer only · b27aad01e7b1c863 · report
icl_prompt weikai202/SkillRAG/prompts.py found in paper text by Syntology unverified no licence file found · pointer only · 45731b6d2e1ad2c1 · report
inst_prompt weikai202/SkillRAG/prompts.py found in paper text by Syntology unverified no licence file found · pointer only · 1a9e85bfc61def74 · report
inverse_weighted_average weikai202/SkillRAG/exp_clf_performance.py found in paper text by Syntology unverified no licence file found · pointer only · 8a1753b44a62ff2c · report
latest_output weikai202/SkillRAG/quick_check_qwen_skillrag_demo.py found in paper text by Syntology unverified no licence file found · pointer only · b2c5969b88f135be · report
missing_ckpts weikai202/SkillRAG/quick_check_qwen_skillrag_demo.py found in paper text by Syntology unverified no licence file found · pointer only · 0a9de72267d6e5c8 · report
pool_hidden_state weikai202/SkillRAG/analyze_hiddenstate_clusters.py found in paper text by Syntology unverified no licence file found · pointer only · cc69f1884f281fda · report
prompt weikai202/SkillRAG/prompts.py found in paper text by Syntology unverified no licence file found · pointer only · 49900ee8e993d110 · report
summarize_file weikai202/SkillRAG/collect_build_metrics.py found in paper text by Syntology unverified no licence file found · pointer only · 1e27e3eabf19e60e · report

Results from the paper

The Papers with Code archive ends with its 2025-07-28 snapshot. This paper's arXiv identifier, 2604.15771, was issued in April 2026, after that date, so the archive has no leaderboard rows for it.

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections