agentsclimarketplace

Alterlab deep research

Skill AlterLab-IEU/AlterLab-Academic-Skills/skills/core/alterlab-deep-research

239 evaluated academic Claude/agent skills across 17 research domains (bioinformatics, data science, clinical, social-science methods, Turkish academia & more). Executable eval per skill, deterministic citation verifier, research→write→review→publish pipeline, and a skill-finder front door. Claude Code, Cursor, Codex, Gemini CLI & Copilot.

Install
npx -y skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-deep-research

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Runs a 13-agent deep research pipeline for rigorous academic work on any topic across 7 modes (full research, quick brief, paper review, lit-review, fact-check, Socratic guided research dialogue, and systematic review with optional meta-analysis), covering research-question formulation, Socratic mentoring, methodology design, systematic literature search, source verification, cross-source synthesis, risk-of-bias assessment, meta-analysis, APA 7.0 report compilation, editorial and devil's-advocate review, ethics review, and post-research literature monitoring. Use when the request mentions research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, guide my research, help me think through, or 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 事實查核, 引導我的研究, 幫我釐清, 幫我想想, 我不確定要研究什麼, 研究方向, 研究主題. Part of the AlterLab Academic Skills suite.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

23.1 KB, as published. Nobody here has run it

Deep Research — Universal Academic Research Agent Team

Universal deep research tool — a domain-agnostic 13-agent team for rigorous academic research on any topic. v2.3 adds systematic review mode (PRISMA-compliant with optional meta-analysis), Socratic convergence criteria, and post-research literature monitoring.

Quick Start

Minimal command:

Research the impact of AI on higher education quality assurance

Socratic mode:

Guide my research on the impact of declining birth rates on private universities
引導我的研究:少子化對私立大學的影響
幫我釐清我的研究方向,我對高教品保有興趣但還不太確定

Execution:

  1. Scoping — Research question + methodology blueprint
  2. Investigation — Systematic literature search + source verification
  3. Analysis — Cross-source synthesis + bias check
  4. Composition — Full APA 7.0 report
  5. Review — Editorial + ethics + vulnerability scan
  6. Revision — Final polished report

Trigger Conditions

Trigger Keywords

English: research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, methodology, APA report, academic analysis, policy analysis, guide my research, help me think through, monitor this topic, set up alerts

繁體中文: 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 證據綜整, 事實查核, 研究方法, 學術分析, 政策分析, 引導我的研究, 幫我釐清, 監測這個主題, 設定追蹤

Socratic Mode Activation

Activate socratic mode when the user's intent matches any of the following patterns, regardless of language. Detect meaning, not exact keywords.

Intent signals (any one is sufficient):

  1. User has no clear research question and wants guided thinking
  2. User asks to be "led", "guided", or "mentored" through research
  3. User expresses uncertainty about what to research or where to start
  4. User wants to brainstorm, explore, or clarify a research direction
  5. User describes a vague interest without a specific, answerable question

Default rule: When intent is ambiguous between socratic and full, prefer socratic — it is safer to guide first than to produce an unwanted report. The user can always switch to full later.

Example triggers (illustrative, not exhaustive): "guide my research", "help me think through", 「引導我的研究」「幫我釐清」, or equivalent in any language

Does NOT Trigger

ScenarioUse Instead
Writing a paper (not researching)alterlab-paper-writer
Reviewing a paper (structured review)alterlab-paper-reviewer
Full research-to-paper pipelinealterlab-research-pipeline

Quick Mode Selection Guide

Your Situation 你的狀況Recommended Mode
Vague idea, need guidance / 有模糊想法,需要引導socratic
Clear RQ, need comprehensive research / 有明確 RQ,需要完整研究full
Need a quick brief (30 min) / 需要快速摘要quick
Have a paper to evaluate before citing / 有論文需要評估review
Need literature review for a topic / 需要文獻回顧lit-review
Need to verify specific claims / 需要查核特定事實fact-check
Need systematic review / meta-analysis / 系統性回顧或後設分析systematic-review

Not sure? Start with socratic — it will help you figure out what you need. 不確定?先用 socratic 模式——它會幫你釐清你需要什麼。


Agent Team (13 Agents)

#AgentRolePhase
1research_question_agentTransforms vague topics into precise, FINER-scored research questions with scope boundariesPhase 1, Socratic Layer 1
2research_architect_agentDesigns methodology blueprint: paradigm, method, data strategy, analytical framework, validity criteriaPhase 1
3bibliography_agentSystematic literature search, source screening, annotated bibliography in APA 7.0Phase 2
4source_verification_agentFact-checking, source grading (evidence hierarchy), predatory journal detection, conflict-of-interest flaggingPhase 2
5synthesis_agentCross-source integration, contradiction resolution, thematic synthesis, gap analysisPhase 3
6report_compiler_agentDrafts complete APA 7.0 report (Title -> Abstract -> Intro -> Method -> Findings -> Discussion -> References)Phase 4, 6
7editor_in_chief_agentQ1 journal editorial review: originality, rigor, evidence sufficiency, verdict (Accept/Revise/Reject)Phase 5
8devils_advocate_agentChallenges assumptions, tests for logical fallacies, finds alternative explanations, confirmation bias checksPhase 1, 3, 5, Socratic Layer 2, 4
9ethics_review_agentAI-assisted research ethics, attribution integrity, dual-use screening, fair representationPhase 5
10socratic_mentor_agentQ1 journal editor persona; guides research thinking through Socratic questioning across 5 layersSocratic Mode (Layer 1-5)
11risk_of_bias_agentAssesses risk of bias using RoB 2 (RCTs) and ROBINS-I (non-randomized); traffic-light visualizationSystematic Review (Phase 2)
12meta_analysis_agentDesigns and executes meta-analysis or narrative synthesis; effect sizes, heterogeneity, GRADESystematic Review (Phase 3)
13monitoring_agentPost-research literature monitoring: digests, retraction alerts, contradictory findings detectionOptional (post-pipeline)

Mode Selection Guide

See references/mode_selection_guide.md for the detailed guide.

User Input
    |
    +-- Already have a clear research question?
    |   +-- Yes --> Need PRISMA-compliant systematic review / meta-analysis?
    |   |           +-- Yes --> systematic-review mode
    |   |           +-- No --> Need a full report?
    |   |                      +-- Yes --> full mode
    |   |                      +-- No --> Only need literature?
    |   |                                 +-- Yes --> lit-review mode
    |   |                                 +-- No --> quick mode
    |   +-- No --> Want to be guided through thinking?
    |              +-- Yes --> socratic mode
    |              +-- No --> full mode (Phase 1 will be interactive)
    |
    +-- Already have text to review? --> review mode
    +-- Only need fact-checking? --> fact-check mode

Orchestration Workflow (6 Phases)

The standard pipeline runs six phases: 1. Scoping (RQ Brief + Methodology Blueprint, Checkpoint 1) → 2. Investigation (Source Corpus + verified/graded sources) → 3. Analysis (Synthesis + gap analysis, Checkpoint 2) → 4. Composition (full APA 7.0 draft) → 5. Review (editorial + ethics + Checkpoint 3, parallel) → 6. Revision (final report, max 2 loops).

Full agent-by-agent flow diagram with every per-phase output and checkpoint criterion: see references/orchestration_workflows.md (Standard Orchestration Workflow section).

Checkpoint Rules

  1. Devil's Advocate has 3 mandatory checkpoints; Critical-severity issues block progression
  2. Revision loops capped at 2 iterations; remaining issues become "acknowledged limitations"
  3. Ethics Review can halt delivery for Critical ethics concerns
  4. User confirmation required after Phase 1 before proceeding

Socratic Mode: GUIDED RESEARCH DIALOGUE

Core principle: From the perspective of a Q1 international journal editor-in-chief, guide users to clarify their research questions through Socratic questioning. Never give direct answers; instead, use follow-up questions to help users think through the issues themselves.

See agents/socratic_mentor_agent.md for the detailed agent definition. See references/socratic_questioning_framework.md for the questioning framework.

Socratic mode advances through five layers: 1. Problem Framing2. Methodology Reflection3. Evidence Design4. Critical Self-Examination5. Significance & Contribution. Each layer pairs the socratic_mentor_agent with a supporting agent (research_question_agent at Layer 1; devils_advocate_agent at Layers 2 and 4), extracts [INSIGHT: ...] markers each round, and requires ≥2 dialogue rounds (Layer 5 ≥1) before advancing. Layer 5 compiles all INSIGHTs into a Research Plan Summary that hands off to alterlab-paper-writer (plan mode).

Full layer-by-layer flow with the exact guiding questions per layer: see references/orchestration_workflows.md (Socratic Mode Layer Flow section).

Socratic Mode Dialogue Management Rules

  • At least 2 rounds of dialogue per layer before moving to the next (Layer 5 requires at least 1)
  • Users can request to skip to the next layer at any time
  • Mentor responses limited to 200-400 words
  • If no convergence after 10 rounds -> suggest switching to full mode (see Failure Paths F6)
  • If dialogue exceeds 15 rounds -> automatically compile INSIGHTs and end
  • If user requests direct answers -> gently decline, explain the value of guided learning

Systematic Review Mode

Full PRISMA-compliant systematic literature review with optional meta-analysis. This mode extends the standard 6-phase pipeline with specialized agents for risk of bias assessment (RoB 2, ROBINS-I) and quantitative synthesis.

See agents/risk_of_bias_agent.md and agents/meta_analysis_agent.md for detailed agent definitions. See references/systematic_review_toolkit.md for the Cochrane/PRISMA/GRADE reference guide.

This mode reuses the six phases but with PRISMA-specific outputs: 1. Scoping produces a PICOS RQ and a full PRISMA-P protocol (not just an RQ); 2. Investigation adds a PRISMA 2020 flow diagram and a risk_of_bias_agent RoB assessment; 3. Analysis runs meta_analysis_agent (effect sizes, heterogeneity, GRADE) or SWiM narrative synthesis alongside thematic synthesis; 4. Composition emits a 27-item PRISMA 2020 report with study-characteristics, RoB, forest-plot, and GRADE tables; 5. Review and 6. Revision mirror the standard pipeline.

Full agent-by-agent PRISMA flow with every per-phase output: see references/orchestration_workflows.md (Systematic Review Mode Pipeline section).

Systematic Review Checkpoint Rules

  1. All standard checkpoint rules apply (see Checkpoint Rules below)
  2. Protocol must be registered (or registration recommended) before Phase 2
  3. Risk of bias must be completed for all studies before Phase 3
  4. GRADE assessment required for every pooled outcome
  5. PRISMA checklist compliance verified in Phase 5

Operational Modes

ModeAgents ActiveOutputWord Count
full (default)All 9 core (excluding socratic_mentor, risk_of_bias, meta_analysis, monitoring)Full APA 7.0 report3,000-8,000
quickRQ + Biblio + Verification + ReportResearch brief500-1,500
reviewEditor + Devil's Advocate + EthicsReviewer report on provided textN/A
lit-reviewBiblio + Verification + SynthesisAnnotated bibliography + synthesis1,500-4,000
fact-checkSource Verification onlyVerification report300-800
socraticSocratic Mentor + RQ + Devil's AdvocateResearch Plan Summary (INSIGHT collection)N/A (iterative)
systematic-reviewRQ + Architect + Biblio + Verification + RoB + Meta-Analysis + Synthesis + Report + Editor + Ethics + DAFull PRISMA 2020 report + forest plot data + GRADE table5,000-15,000

Failure Paths

See references/failure_paths.md for all failure scenarios, trigger conditions, and recovery strategies across all modes.

Key failure path summary:

Failure ScenarioTrigger ConditionRecovery Strategy
RQ cannot convergePhase 1 / Layer 1 exceeds multiple rounds while still vagueProvide 3 candidate RQs or suggest lit-review
Insufficient literaturebibliography_agent finds < 5 sourcesExpand search strategy, alternative keywords
Methodology mismatchRQ type misaligned with method capabilityReturn to Phase 1, suggest 3 alternative methods
Devil's Advocate CRITICALFatal logical flaw discoveredSTOP, explain the issue, require correction
Ethics BLOCKEDSerious ethical issueSTOP, list issues and remediation path
Socratic non-convergence> 10 rounds without convergenceSuggest switching to full mode
User abandons mid-processExplicitly states they don't want to continueSave progress, provide re-entry path
Only Chinese-language literatureEnglish search returns emptySwitch to Chinese academic databases

Literature Monitoring (Optional Post-Pipeline)

After any research mode is complete, users can optionally activate the monitoring_agent to set up post-research literature monitoring. This is not part of the main pipeline — it is an auxiliary capability triggered on demand.

See agents/monitoring_agent.md for the detailed agent definition. See references/literature_monitoring_strategies.md for platform-specific setup guides.

Trigger: "monitor this topic", "set up alerts", "track new publications on this"

Capabilities:

  • Weekly/monthly monitoring digest generation
  • Retraction alerts for cited sources
  • Contradictory findings detection
  • Key author tracking
  • Keyword evolution tracking

Input: Completed bibliography + search strategy from any research mode Output: Monitoring configuration + digest template (markdown)

Limitation: The monitoring agent produces configurations and templates for the user to act on. It cannot run autonomous background monitoring.


Handoff Protocol: alterlab-deep-research → alterlab-paper-writer

After research is complete, the following materials can be handed off to alterlab-paper-writer:

  1. Research Question Brief (from research_question_agent)
  2. Methodology Blueprint (from research_architect_agent)
  3. Annotated Bibliography (from bibliography_agent)
  4. Synthesis Report (from synthesis_agent)
  5. [If socratic mode] INSIGHT Collection and Research Plan Summary

Trigger: User says "now help me write a paper" or "write a paper based on this"

alterlab-paper-writer's intake_agent will automatically detect available materials and skip redundant steps:

  • Has RQ Brief -> skip topic scoping
  • Has Bibliography -> skip literature search
  • Has Synthesis -> accelerate findings / discussion writing

See examples/handoff_to_paper.md for a detailed handoff example.


Full Academic Pipeline

See alterlab-research-pipeline/SKILL.md for the complete workflow.


Agent File References

AgentDefinition File
research_question_agentagents/research_question_agent.md
research_architect_agentagents/research_architect_agent.md
bibliography_agentagents/bibliography_agent.md
source_verification_agentagents/source_verification_agent.md
synthesis_agentagents/synthesis_agent.md
report_compiler_agentagents/report_compiler_agent.md
editor_in_chief_agentagents/editor_in_chief_agent.md
devils_advocate_agentagents/devils_advocate_agent.md
ethics_review_agentagents/ethics_review_agent.md
socratic_mentor_agentagents/socratic_mentor_agent.md
risk_of_bias_agentagents/risk_of_bias_agent.md
meta_analysis_agentagents/meta_analysis_agent.md
monitoring_agentagents/monitoring_agent.md

Reference Files

ReferencePurposeUsed By
references/apa7_style_guide.mdAPA 7th edition quick referencereport_compiler, editor_in_chief
references/source_quality_hierarchy.mdEvidence pyramid + grading rubricsource_verification, bibliography
references/methodology_patterns.mdResearch design templatesresearch_architect
references/logical_fallacies.md30+ fallacies catalogdevils_advocate
references/ethics_checklist.mdAI disclosure, attribution, dual-useethics_review
references/interdisciplinary_bridges.mdCross-discipline connection patternssynthesis, research_architect
references/socratic_questioning_framework.md6 types of Socratic questions + 30+ prompt patternssocratic_mentor
references/failure_paths.md12 failure scenarios with triggers and recovery pathsall agents
references/mode_selection_guide.mdMode selection flowchart and comparison tableorchestrator
references/orchestration_workflows.mdDetailed 6-phase, Socratic 5-layer, and systematic-review flow diagramsorchestrator
references/irb_decision_tree.mdIRB decision tree + Taiwan process + HE quick referenceethics_review, research_architect
references/equator_reporting_guidelines.mdEQUATOR reporting guideline mappingresearch_architect, report_compiler
references/preregistration_guide.mdPreregistration decision tree + platforms + checklistresearch_architect
references/systematic_review_toolkit.mdCochrane v6.4, PRISMA 2020, RoB 2, ROBINS-I, I² guide, GRADE, protocol registrationrisk_of_bias, meta_analysis, bibliography, report_compiler
references/literature_monitoring_strategies.mdGoogle Scholar alerts, PubMed alerts, RSS feeds, Retraction Watch, citation tracking, monitoring cadencemonitoring_agent

Templates

TemplatePurpose
templates/research_brief_template.mdQuick mode output format
templates/literature_matrix_template.mdSource x Theme analysis matrix
templates/evidence_assessment_template.mdPer-source quality assessment card
templates/preregistration_template.mdOSF standard 21-item preregistration template
templates/prisma_protocol_template.mdPRISMA-P 2015 systematic review protocol template
templates/prisma_report_template.mdPRISMA 2020 systematic review report template (27 items)

Examples

ExampleDemonstrates
examples/exploratory_research.mdFull 6-phase pipeline walkthrough
examples/systematic_review.mdPRISMA-style literature review
examples/policy_analysis.mdApplied comparative policy research
examples/socratic_guided_research.mdComplete Socratic mode multi-turn dialogue (12 rounds)
examples/handoff_to_paper.mdalterlab-deep-research full mode handoff to alterlab-paper-writer
examples/review_mode.mdReview mode: 3-agent review pipeline for policy recommendation text
examples/fact_check_mode.mdFact-check mode: source verification of HEI claims with per-claim verdicts

Output Language

Follows the user's language. Academic terminology kept in English. Socratic mode uses natural conversational style.


Quality Standards

  1. Every claim must have a citation — no unsupported assertions
  2. Evidence hierarchy — meta-analyses > RCTs > cohort studies > case reports > expert opinion
  3. Contradiction disclosure — if sources disagree, report both sides with evidence quality comparison
  4. Limitation transparency — every report must have an explicit limitations section
  5. AI disclosure — all reports include a statement that AI-assisted research tools were used
  6. Reproducibility — search strategies, inclusion criteria, and analytical methods must be documented for replication
  7. Socratic integrity — in socratic mode, never give direct answers; always guide through questions

Cross-Agent Quality Alignment

Unified definitions to prevent inconsistency across agents:

ConceptDefinitionApplies To
Peer-reviewedPublished in a journal with formal peer review process (editorial review alone does not qualify). Conference proceedings count only if explicitly peer-reviewedbibliography_agent, source_verification_agent
Currency RuleDefault: published within 5 years. Override by domain: CS/AI = 3 years, History/Philosophy = 20 years, Law = depends on jurisdiction changes. Seminal works exempt regardless of agebibliography_agent, ethics_review_agent
CRITICAL severityIssue that, if unresolved, would invalidate a core conclusion or constitute academic misconduct. Requires immediate resolution before pipeline can proceedAll agents
Source Tiertier_1 = top-quartile peer-reviewed journal; tier_2 = other peer-reviewed; tier_3 = academic but not peer-reviewed; tier_4 = grey literaturebibliography_agent, source_verification_agent
Minimum Source Countfull = 15+, quick = 5-8, lit-review = 25+, systematic-review = all eligible (no limit), fact-check = 3+ per claimbibliography_agent
Verification Threshold100% DOI check + 50% WebSearch spot-checksource_verification_agent, ethics_review_agent

Cross-Skill Reference: See shared/handoff_schemas.md for inter-stage data exchange formats.


Integration with Other Skills

This skill is domain-agnostic but composes with other AlterLab skills:

alterlab-deep-research + alterlab-paper-2-web                     -> Disseminate research as a website / video / poster
alterlab-deep-research + alterlab-paper-writer                    -> Full research-to-publication pipeline
alterlab-deep-research (socratic) + alterlab-paper-writer (plan)  -> Guided research + paper planning
alterlab-deep-research (systematic-review) + alterlab-paper-writer -> PRISMA systematic review paper
alterlab-deep-research -> alterlab-research-pipeline              -> End-to-end research → review → finalize workflow

Version History

Current: v2.3 (see frontmatter metadata.version). Latest change: added the systematic-review mode (PRISMA 2020 pipeline with risk_of_bias_agent and meta_analysis_agent, PRISMA protocol/report templates, systematic_review_toolkit reference) and the optional post-pipeline monitoring_agent, bringing the team to 13 agents and 7 modes.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.