acesearcher-reasoning-search-self-play
Train a single LLM to decompose complex queries into subquestions and integrate retrieved contexts through two-stage supervised and preference-based…
Skill by ADu2021
Chalk Labs
Need help deploying acesearcher-reasoning-search-self-play?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/adu2021-acesearcher-reasoning-search-self-play
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: ml
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/acesearcher-reasoning-search-self-play
What's inside
- Skill name
acesearcher-reasoning-search-self-play- Description
- Train a single LLM to decompose complex queries into subquestions and integrate retrieved contexts through two-stage supervised and preference-based reinforcement fine-tuning, achieving 7.6% average improvement and matching 685B models with 32B parameters.
- License
- MIT
- Instructions
- 490 lines in SKILL.md · view on GitHub
Files (1)
- SKILL.md
SKILL.md (first lines)
## AceSearcher: Bootstrapping Reasoning and Search for LLMs via Reinforced Self-Play
### Outcome
Implement a cooperative self-play framework that trains a single LLM to alternate between decomposer and solver roles, enhancing multi-hop reasoning and retrieval-augmented generation without requiring intermediate answer annotations. Achieve parameter-efficient performance matching much larger models through iterative preference optimization.
### Problem Context
Complex question answering demands multi-step reasoning and precise information retrieval. Traditional approaches struggle with:
- Decomposing ambiguous queries into retrievable subquestions
- Integrating multiple retrieved passages without losing coherence
- Requiring expensive intermediate supervision for each reasoning step
- Scaling linearly with model size for competitive performance
AceSearcher addresses these by training a single LLM to handle both question decomposition and answer synthesis through self-play, using only final-answer signals for optimization.
### Core Concept
AceSearcher treats reasoning as a cooperative process between two roles played by the same model:
**Decomposer (ρ)**: Transforms an input question into a sequence of subquestions designed to guide retrieval. Given question q, produces subquestions z = (z₁, z₂, ..., zₙ).
**Solver (π)**: Generates intermediate answers for each subquestion by consulting retrieved documents, then synthesizes all intermediate answers into a final response. Takes subquestion zᵢ, prior answers w<ᵢ, and retrieved context Dᵢ to produce intermediate answer wᵢ, then generates final answer a' from all components.
The key insight is that better decompositions enable the solver to retrieve more relevant context and produce higher-quality answers. This mutual dependency justifies joint optimization without separate roles or models.
### Architecture Overview
- **Unified Model**: Single LLM controlled by templates and prompts, no separate role-specific parameters
- **Two-Stage Training**: Supervised fine-tuning on diverse reasoning tasks, followed by preference-based reinforcement optimization
- **Preference Generation**: Multipath rollouts sample multiple decompositions and solution paths, creating preference pairs from max/min trajectories
- **Iterative DPO**: Direct Preference Optimization applied across three preference datasets (decomposition quality, intermediate answers, final answers) with convergence guarantees
- **Retrieval Integration**: Sparse retrieval allocates documents per subquestion (typically 15 total documents distributed across decomposed steps)
### Implementation
#### Stage 1: Supervised Fine-Tuning on Diverse Tasks
The foundation requires exposure to search, reasoning, and decomposition patterns across 180,600 examples:
```python
# sft_data_preparation.py
from dataclasses import dataclass
from typing import List
@dataclass
class SFTExample:
instruction: str
input: str
output: str
task_category: str # "search", "reasoning", "decomposition"
# Data composition
sft_datasets = {
"context_rich_qa": {
"sources": ["NQ", "SQuAD", "DROP", "NarrativeQA", "Quoref", "ROPES", "FEVER", "TAT-QA"],
"count": 132000,
"purpose": "Extract answers from retrieved contexts"
},
"question_decomposition": {
"sources": ["GSM8K", "ConvFinQA", "StrategyQA"],
"count": 9600,
"purpose": "Break complex questions into subquestions"
},
"chain_of_thought": {
"sources": ["GSM8K", "TabMWP", "IfQA", "MathInstruct"],
"count": 39000,
"purpose": "Multi-step reasoning patterns"
}
}
total_sft_examples = sum(v["count"] for v in sft_datasets.values())
# Result: 180,600 examples
# Hyperparameters for SFT
sft_config = {
"batch_size": 64,
"max_tokens": 2560,
"epochs": 1,
"warmup_steps_ratio": 0.05,
"learning_rates": {
"1.5B": 5e-6,
"8B": 1e-6,
"14B": 1e-6,
"32B_LoRA": 1e-5
},
"optimizer": "AdamW",
"lr_scheduler": "cosine"
}
```
Use standard next-token prediction loss. Mix tasks equally to ensure the model learns all three competencies.
#### Stage 2: Preference-Based Reinforcement Fine-Tuning
Generate preference pairs via multipath rollouts and optimize with iterative DPO:
```python
# preference_generation.py
import numpy as np
from typing import Tuple, List
class PreferenceDataGenerator:
def __init__(self, model, retriever, num_decompositions=3, num_solutions=4):
self.model = model
self.retriever = retriever
self.m = num_decompositions # candidate decompositions per question
self.m_prime = num_solutions # candidate solutions per decomposition
def compute_reward(self, question: str, answer: str, gold_answer: str) -> float:
"""
Reward function: exact match with format validation
r(q, a', a) = EM(a', a) × 𝕀(f(q, a') = 1)
"""
em_score = 1.0 if self._normalize_answer(answer) == self._normalize_answer(gold_answer) else 0.0
format_valid = self._check_format(question, answer)
return em_score * float(format_valid)From ADu2021/skillXiv, MIT.
More from ADu2021/skillXiv
- 0.467score
a-bertology-view-of-llm-orchestrations-token-and
ADu2021
Production LLM systems often rely on separate models for safety and other classification-heavy steps, increasing latency, VRAM footprint, and operational…
SkillDFreshness: D★ 6Claude Code +9 - 0.467score
abc-bench-benchmarking-agentic-backend-coding-in
ADu2021
The evolution of Large Language Models (LLMs) into autonomous agents has expanded the scope of AI coding from localized code generation to complex…
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
acon-context-compression-agents
ADu2021
Reduce memory overhead of long-horizon LLM agents by learning task-specific context compression strategies.
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
ace-confidence-penalty
ADu2021
Asymmetric Confidence-aware Error Penalty (ACE) dynamically penalizes overconfident mistakes in RL training, improving reasoning quality without requiring…
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
aceff-a-state-of-the-art-machine-learning-potentia
ADu2021
Research contribution advancing agent and reasoning capabilities through novel approaches to model development, training, and evaluation.
SkillDFreshness: D★ 6Claude Code +9 - 0.463score
paper2skill-v0.0.3
ADu2021
Convert arXiv papers into ready-to-use agent skills using category-aware extraction.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper2skill-mechanistic-analysis
ADu2021
Convert mechanistic analysis papers into transferable analytical methodology skills.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper2skill-paradigm-challenge
ADu2021
Convert papers that disprove conventional wisdom into paradigm-challenge skills.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper2skill-research-infrastructure
ADu2021
Convert research infrastructure papers into design pattern guides.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper-categorizer
ADu2021
Categorize ML/AI research papers into 11 types based on their title and abstract.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper2skill-survey-synthesis
ADu2021
Convert survey and synthesis papers into field navigation guides.
SkillDFreshness: D★ 6Claude Code +9 - 0.462score
paper2skill-systematic-empiricism
ADu2021
Convert systematic empiricism papers into ranked practitioner checklists.
SkillDFreshness: D★ 6Claude Code +9
Signals
- Stars
- 6
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Mar 24, 2026 (7 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/ADu2021/skillXiv
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from ADu2021
- 0.467score
a-bertology-view-of-llm-orchestrations-token-and
ADu2021
Production LLM systems often rely on separate models for safety and other classification-heavy steps, increasing latency, VRAM footprint, and operational…
SkillDFreshness: D★ 6Claude Code +9 - 0.467score
abc-bench-benchmarking-agentic-backend-coding-in
ADu2021
The evolution of Large Language Models (LLMs) into autonomous agents has expanded the scope of AI coding from localized code generation to complex…
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
aceff-a-state-of-the-art-machine-learning-potentia
ADu2021
Research contribution advancing agent and reasoning capabilities through novel approaches to model development, training, and evaluation.
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
acon-context-compression-agents
ADu2021
Reduce memory overhead of long-horizon LLM agents by learning task-specific context compression strategies.
SkillDFreshness: D★ 6Claude Code +9 - 0.464score
ace-confidence-penalty
ADu2021
Asymmetric Confidence-aware Error Penalty (ACE) dynamically penalizes overconfident mistakes in RL training, improving reasoning quality without requiring…
SkillDFreshness: D★ 6Claude Code +9 - 0.463score
paper2skill-v0.0.3
ADu2021
Convert arXiv papers into ready-to-use agent skills using category-aware extraction.
SkillDFreshness: D★ 6Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get acesearcher-reasoning-search-self-play running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
acesearcher-reasoning-search-self-play skill. Agent Mart. https://agentmart.dev/skills/adu2021-acesearcher-reasoning-search-self-play (last updated 2026-10-24)