agent-research-aggregator

Aggregate agent cache logs into PaperOrchestra-ready idea.md and experimental_log.md files.

2|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/raja21068/AutoResearch --skill agent-research-aggregator-raja21068
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-research-aggregator
Source: https://github.com/raja21068/AutoResearch/tree/main/skills/paper-pipeline/agent-research-aggregator
Command: npx skills add https://github.com/raja21068/AutoResearch --skill agent-research-aggregator-raja21068

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, json, pathlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It turns scattered AI agent experimentation history into the structured idea and experimental log files needed for paper writing, saving you from manually hunting across cache folders and reformatting results.

Core Features & Use Cases

  • Discovers experiments in agent caches: scans common cache directories like .claude, .cursor, .antigravity, and .openclaw (read-only) to find relevant logs and numeric outputs.
  • Extracts structured experiment records: uses an LLM-assisted extraction pass to build a consistent JSON representation of hypotheses, methods, setups, results, and iterations.
  • Synthesizes a coherent research narrative: consolidates extracted experiments into a single synthesis.json, then deterministically formats PaperOrchestra-ready workspace/inputs/idea.md and workspace/inputs/experimental_log.md.
  • Prevents unnecessary work: skips entirely when workspace/inputs/idea.md and workspace/inputs/experimental_log.md already exist and are non-empty.

Quick Start

Run the skill with your agent-log root directory so it can generate workspace/inputs/idea.md and workspace/inputs/experimental_log.md for paper-orchestra.

Frequently Asked Questions about agent-research-aggregator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn scattered AI agent logs into research paper inputs?

To turn scattered AI agent logs into research paper inputs, this skill scans cache directories like .claude and .cursor to discover experiment records, extracts structured data via LLM synthesis, and formats them into idea.md and experimental_log.md files for paper writing.

Can I automatically extract experiment records from .claude or .cursor cache folders?

Yes, you can automatically extract experiment records from .claude, .cursor, .antigravity, or .openclaw cache folders. The skill performs a read-only scan to find relevant logs and uses an LLM-assisted pass to build a consistent JSON representation of hypotheses, methods, and results.

What is the best way to prepare PaperOrchestra workspace inputs from past agent runs?

The best way to prepare PaperOrchestra workspace inputs from past agent runs is to run this skill with your agent-log root directory. It consolidates extracted experiments into a synthesis.json and deterministically generates the required workspace/inputs/idea.md and experimental_log.md files.

Does the agent log aggregation process overwrite existing idea.md or experimental_log.md files?

No, the agent log aggregation process does not overwrite existing files. It includes a prevention mechanism that skips entirely when workspace/inputs/idea.md and workspace/inputs/experimental_log.md already exist and are non-empty, avoiding unnecessary work.

Do I need Python to format experimental logs for paper writing?

Yes, you need Python to format experimental logs for paper writing, as the skill depends on Python, json, and pathlib to discover files, extract experiment records, and synthesize them into structured markdown inputs.

Why does my agent log extraction require a project selection step before generating files?

Agent log extraction requires a project selection step because the skill enforces a project-selection gate before initiating LLM extraction. This ensures the aggregation process targets the correct experimental context before generating your workspace inputs.