Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Orchestrate a multi-agent virtual academic reading group. Use when reading multiple papers, generating expert discussion notes, cross-examining positions acr...
Orchestrate a multi-agent virtual academic reading group. Use when reading multiple papers, generating expert discussion notes, cross-examining positions acr...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Orchestrate parallel expert agents to read papers, discuss findings, challenge each other's interpretations, and synthesize an integrated discussion document with traceable citations.
Minimum inputs required: Research question โ the lens through which papers are analyzed Paper list โ paths to PDFs/text files, or paper descriptions for web lookup Output directory โ where all outputs are written Optional inputs: Custom expert personas (default: see references/default-personas.md) Custom junior researcher persona Language preference (default: English) Number of experts (default: auto-calculated from paper count)
The skill runs 4 sequential phases. Each phase must complete before the next begins. PhaseAgentsInputOutput1. Paper ReadingN experts (parallel)Papers + research question{AuthorYear}_notes.md, {Expert}_session_summary.md2. Junior Discussion1 junior researcherAll Phase 1 outputs{Junior}_discussion.md3. Expert ResponsesN experts (parallel)Phase 2 output + other experts' summaries{Expert}_response_to_{Junior}.md4. Synthesis1 synthesizerAll previous outputsIntegrated_Discussion_Summary.md For detailed prompts and phase specifications: Read references/workflow.md.
โ ๏ธ Important: The prompts below are abbreviated summaries. For full prompt templates that produce quality output, use references/workflow.md. The pseudocode blocks show orchestration structure โ adapt to your actual sub-agent spawning mechanism.
Determine number of experts and paper batches: if paper_count <= 4: num_experts = 1 elif paper_count <= 10: num_experts = 2 elif paper_count <= 20: num_experts = min(4, ceil(paper_count / 5)) else: num_experts = min(8, ceil(paper_count / 5)) Distribute papers evenly across experts (max 5 per expert). # โ ๏ธ Context contamination warning: assigning >5 papers per expert degrades # note quality โ later papers in the batch get shallower treatment as context # fills up. Prefer 3-5 papers per agent for best results.
For each expert, spawn a sub-agent with: Label: expert-reader-{expert_name} Model: opus (or sonnet for budget) Core instructions: Read assigned papers through research question lens Write notes using references/paper-notes-template.md Save as {output_dir}/{AuthorYear}_notes.md Write session summary with cross-cutting themes Critical: Quote specific passages with section labels โ all claims must be traceable ๐ Full prompt template: See references/workflow.md โ Phase 1 Wait for all Phase 1 agents to complete before proceeding.
Spawn single agent with: Label: junior-discussion Model: opus (required โ needs strong reasoning) Core instructions: Read all Phase 1 outputs (notes + summaries) For each paper: summarize claims, pose challenging questions to each expert Generate Grand Questions: 3 unsolved problems, 2 testable hypotheses, 2 methodological gaps Reference specific passages โ be intellectually provocative ๐ Full prompt template: See references/workflow.md โ Phase 2 Wait for Phase 2 to complete before proceeding.
For each expert, spawn a sub-agent with: Label: expert-response-{expert_name} Model: opus (recommended) Core instructions: Read junior's discussion + other experts' summaries + own notes Respond to each question directed at them (150-300 words per response) Reference specific paper passages, engage with other expert's perspective Respond to Grand Questions from their domain expertise Be collegial but intellectually rigorous โ disagree where warranted ๐ Full prompt template: See references/workflow.md โ Phase 3 Wait for all Phase 3 agents to complete before proceeding.
Spawn single agent with: Label: synthesis Model: opus (required โ complex reasoning) Core instructions: Read ALL files from Phases 1-3 Follow assets/synthesis-template.md structure Organize by THEME, not by paper or speaker Every claim attributed: [Expert_A]/[Expert_B]/[Junior] + (PaperCode, ยงSection) Include: Points of Consensus, Points of Disagreement, Open Questions Synthesize, don't summarize โ find the intellectual threads ๐ Full prompt template: See references/workflow.md โ Phase 4
List all generated files and provide a brief summary of the discussion themes.
If user wants experts to expand on specific points: Spawn new expert response agent(s) with targeted follow-up questions Re-run Phase 4 synthesis including the additional responses
For a full second round (new questions, new responses): Rename Phase 2-4 outputs with round suffix (e.g., Chen_discussion_r1.md) Re-run Phase 2 with instruction to build on previous round Continue through Phases 3-4
If a phase fails: Check error handling in references/workflow.md Retry failed agent(s) individually Continue from last successful phase (outputs are saved incrementally)
File TypePatternExamplePaper notes{FirstAuthorLastName}{Year}_notes.mdChen2024_notes.mdExpert summary{ExpertLastName}_session_summary.mdLin_session_summary.mdJunior discussion{JuniorLastName}_discussion.mdChen_discussion.mdExpert response{ExpertLastName}_response_to_{JuniorLastName}.mdLin_response_to_Chen.mdSynthesisIntegrated_Discussion_Summary.mdโ
Enforce in all agent prompts: Every factual claim must reference a paper Use format: (AuthorYear, ยงSection) or (AuthorYear, p.X) Direct quotes must include section/page Discussion claims must attribute speaker: [Expert_A], [Expert_B], [Junior]
Never fabricate citations. If an agent cannot find the exact passage in the source text: Leave the field blank or write <!-- source not found --> Do NOT paraphrase and present it as a quote Do NOT infer what the paper "probably says" Fabricated citations are worse than missing citations โ they corrupt the knowledge base silently. Accuracy > Coverage.
If a paper has no PDF or markdown source available: Write a placeholder note with status ๐ญ ๆช่ฎ Leave all content sections blank Do NOT attempt to write notes from memory or web search results Only write substantive notes when the actual source document is accessible.
PapersExpertsBatchesEstimated Time1-61115-20 min7-122220-30 min13-243-43-430-45 min25-504-85-845-90 min
Replace default personas by providing: Expert A: Dr. [Name], [Role]. Background in [X]. Emphasizes [methodology/perspective]. Skeptical of [Y]. Tone: [collegial/rigorous/provocative]. Expert B: Dr. [Name], [Role]. Background in [X]. ... See references/default-personas.md for complete templates.
Pass the language parameter when invoking the orchestration: All agent prompts include Language: {language} instruction Agents read papers and write outputs in the specified language Default: English Example: "Run the reading group in Japanese" โ adds Language: Japanese to all phase prompts.
Model choice significantly impacts output quality and cost: ConfigurationPhasesQualityCostUse WhenFull opusAll phases use opusHighest$$$Publication-quality analysis, complex papersMixedPhase 1: sonnet, Phases 2-4: opusHigh$$Good balance โ reading is less reasoning-intensiveBudgetAll phases use sonnetMedium$Quick exploration, simpler papers Recommendations: Phase 2 (Junior Discussion) benefits most from opus โ requires synthesizing multiple papers and generating non-obvious questions Phase 4 (Synthesis) also benefits from opus โ thematic organization requires complex reasoning Phase 1 (Reading) can use sonnet if papers aren't highly technical Phase 3 (Responses) can use sonnet if questions are straightforward
This skill is standalone but works well with paper collection workflows: literature-manager or similar skills: Use to gather and organize papers first, then pass the collection to virtual-reading-group PDF extraction tools: Pre-extract text from PDFs if agents have trouble reading them directly
references/workflow.md โ Detailed phase specifications and full prompt templates references/default-personas.md โ Ready-to-use expert and junior researcher personas references/paper-notes-template.md โ Template for individual paper notes
assets/synthesis-template.md โ Structure for the final integrated discussion summary
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.