agentleFS
echoleesongecholeesong/claude-skills-plugin/skills/deep-research/SKILL.md

deep-research

Skill4 starsChanged 5 months agoMITView on GitHub

Universal deep research agent team. 13-agent pipeline for rigorous academic research on any topic. 7 modes: full research, quick brief, paper review, lit-review, fact-check, Socratic guided research dialogue, and systematic review with optional meta-analysis. Covers 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 review, devil's advocate challenges, ethics review, and post-research literature monitoring. Triggers on: research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, guide my research, help me think through, 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 事實查核, 引導我的研究, 幫我釐清, 幫我想想, 我不確定要研究什麼, 研究方向, 研究主題.

196 other projects use a version of this, 7 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use community-led-growth, ph-community-outreach and 7 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • nicepkgSkill

    community-led-growth

    Expert in community-led growth (CLG) - leveraging user communities to drive acquisition, retention, and expansion. Covers building developer communities, user groups, ambassador programs, and turning customers into advocates. Knows the difference between community as a feature vs community as a growth engine, and how to measure community ROI. Use when "community-led, CLG, ambassador program, champion program, user community, developer community, word of mouth, user group, " mentioned.

    Also in 5 projects that use this

  • nicepkgSkill

    ph-community-outreach

    Engage Reddit, Indie Hackers, Hacker News and other communities for Product Hunt launches. Use this skill to identify relevant communities, craft appropriate posts, and drive cross-platform engagement without appearing spammy.

    Also in 5 projects that use this

  • xfstudioSkill

    micro-saas-launcher

    Expert in launching small, focused SaaS products fast - the indie hacker approach to building profitable software. Covers idea validation, MVP development, pricing, launch strategies, and growing to sustainable revenue. Ship in weeks, not months. Use when: micro saas, indie hacker, small saas, side project, saas mvp.

    Also in 5 projects that use this

  • stophobiaSkill

    surprise-me

    Create a delightful, unexpected "wow" experience for the user by dynamically discovering and creatively combining other enabled skills. Triggers when the user says "surprise me" or any request expressing a desire for an unexpected creative showcase. Also triggers when the user is bored, wants inspiration, or asks for "something interesting".

    Also in 4 projects that use this

  • HK-hubSkill

    consulting-analysis

    Use this skill when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial analysis, industry research, competitive intelligence, investment due diligence, or any consulting-grade analytical report. This skill operates in two phases — (1) generating a structured analysis framework with chapter skeleton, data query requirements, and analysis logic, and (2) after data collection by other skills, producing the final consulting-grade report with structured narratives, embedded charts, and strategic insights.

    Also in 5 projects that use this

  • +4 more from nicepkg

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 0 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 177 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Default rule: When intent is ambiguous between socratic and full, prefer socratic — it is safer to guide first than to produce an unwanted …

    line 70
  2. Very specific:

    Not sure? Start with socratic — it will help you figure out what you need.

    line 97
  3. Very specific:

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

    line 344

“Common” is measured: kept by at least 6 in 10 of the 177 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.4 adds writing quality improvements to the report compiler:

  • Style Profile consumption (optional) — If a Style Profile is available from academic-paper intake, the report compiler applies it as a soft guide for the Executive Summary and Synthesis sections. Discipline conventions and report objectivity take priority.
  • Writing Quality Check — The report compiler runs a writing quality checklist before finalizing: flags AI-typical overused terms, checks sentence/paragraph length variation, removes throat-clearing openers. See academic-paper/references/writing_quality_check.md.

Routing discipline (v3.9.2): see .claude/CLAUDE.md "Routing Discipline (v3.9.2)" + shared/references/intent_clarification_protocol.md for cross-skill routing rules. This skill assumes routing has already settled — ambiguous cross-phase materials should have been clarified upstream.

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)academic-paper
Reviewing a paper (structured review)academic-paper-reviewer
Full research-to-paper pipelineacademic-pipeline

Quick Mode Selection Guide

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

Spectrum (v3.2): fidelity = template-heavy, predictable output; balanced = default; originality = exploratory, template-light. See shared/mode_spectrum.md for the full cross-skill spectrum table.

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)

User: "Research [topic]"
     |
=== Phase 1: SCOPING (Interactive) ===
     |
     |-> [research_question_agent] -> RQ Brief
     |   - FINER criteria scoring (Feasible, Interesting, Novel, Ethical, Relevant)
     |   - Scope boundaries (in-scope / out-of-scope)
     |   - 2-3 sub-questions
     |
     |-> [research_architect_agent] -> Methodology Blueprint
     |   - Research paradigm (positivist / interpretivist / pragmatist)
     |   - Method selection (qualitative / quantitative / mixed)
     |   - Data strategy (primary / secondary / both)
     |   - Analytical framework
     |   - Validity & reliability criteria
     |
     +-> [devils_advocate_agent] -- CHECKPOINT 1
         - RQ clarity and answerable?
         - Method appropriate for question?
         - Scope too broad or too narrow?
         - Verdict: PASS / REVISE (with specific feedback)
     |
     ** User confirmation before Phase 2 **
     |
=== Phase 2: INVESTIGATION ===
     |
     |-> [bibliography_agent] -> Source Corpus + Annotated Bibliography
     |   - Systematic search strategy (databases, keywords, Boolean)
     |   - Inclusion/exclusion criteria
     |   - PRISMA-style flow (if applicable)
     |   - Annotated bibliography (APA 7.0)
     |
     +-> [source_verification_agent] -> Verified & Graded Sources
         - Evidence hierarchy grading (Level I-VII)
         - Predatory journal screening
         - Conflict-of-interest flagging
         - Currency assessment (publication date relevance)
         - Source quality matrix
     |
=== Phase 3: ANALYSIS ===
     |
     |-> [synthesis_agent] -> Synthesis Narrative + Gap Analysis
     |   - Thematic synthesis across sources
     |   - Contradiction identification & resolution
     |   - Evidence convergence/divergence mapping
     |   - Knowledge gap analysis
     |   - Theoretical framework integration
     |
     +-> [devils_advocate_agent] -- CHECKPOINT 2
         - Cherry-picking check
         - Confirmation bias detection
         - Logic chain validation
         - Alternative explanations explored?
         - Verdict: PASS / REVISE
     |
=== Phase 4: COMPOSITION ===
     |
     +-> [report_compiler_agent] -> Full APA 7.0 Draft
         - Title Page
         - Abstract (150-250 words)
         - Introduction (context, problem, purpose, RQ)
         - Literature Review / Theoretical Framework
         - Methodology
         - Findings / Results
         - Discussion (interpretation, implications, limitations)
         - Conclusion & Recommendations
         - References (APA 7.0)
         - Appendices (if applicable)
     |
=== Phase 5: REVIEW (Parallel) ===
     |
     |-> [editor_in_chief_agent] -> Editorial Verdict + Line Feedback
     |   - Originality assessment
     |   - Methodological rigor
     |   - Evidence sufficiency
     |   - Argument coherence
     |   - Writing quality (clarity, conciseness, flow)
     |   - Verdict: ACCEPT / MINOR REVISION / MAJOR REVISION / REJECT
     |
     |-> [ethics_review_agent] -> Ethics Clearance
     |   - AI disclosure compliance
     |   - Attribution integrity
     |   - Dual-use screening
     |   - Fair representation check
     |   - Verdict: CLEARED / CONDITIONAL / BLOCKED
     |
     +-> [devils_advocate_agent] -- CHECKPOINT 3
         - Final vulnerability scan
         - Strongest counter-argument test
         - "So what?" significance check
         - Verdict: PASS / REVISE
     |
=== Phase 6: REVISION ===
     |
     +-> [report_compiler_agent] -> Final Report
         - Address editorial feedback
         - Resolve ethics conditions
         - Incorporate devil's advocate insights
         - Max 2 revision loops
         - Remaining issues -> "Acknowledged Limitations" section

Checkpoint Rules

  1. ⚠️ IRON RULE: 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. ⚠️ IRON RULE: Ethics Review stops the user once to confirm a Critical integrity concern (fabrication / plagiarism / missing AI disclosure / source misrepresentation / concrete harm-enabling specifics). Overridable with recorded reasoning — it confirms, it does not veto. Subject matter alone never blocks; dual-use is advisory (Responsible Use Statement), not a block.
  4. User confirmation required after Phase 1 before proceeding

Phase-by-phase Invocation Contract (v3.9.2)

ARS pipeline runs in 6 phases. Two invocation modes:

Mode A — orchestrator-driven (default): pipeline_orchestrator_agent (in academic-pipeline skill) runs all phases end-to-end with state tracking via Material Passport.

Mode B — phase-by-phase (cross-session resume): User invokes one agent per phase across sessions for long-running projects. Common pattern via ARS_PASSPORT_RESET=1 + resume_from_passport=<hash> (see academic-pipeline/references/passport_as_reset_boundary.md).

In Mode B, single-phase agents (Bucket A per docs/design/2026-05-18-ars-v3.9.2-agent-phase-classification.md) stay strictly within their assigned phase for writes. Reads from upstream phases are allowed. Multi-phase agents (Bucket B: devils_advocate_agent, report_compiler_agent) do exactly the work specified by the caller's invocation for that phase — no extension to other phases in the same call.

Routing into Mode B requires explicit user signal — /ars-<mode> slash command or [direct-mode] prefix. Ambiguous cross-phase input defaults to clarification per .claude/CLAUDE.md Routing Discipline + shared/references/intent_clarification_protocol.md.

Enforcement (v3.9.2): prompt-level via Phase Boundary blocks on Bucket A agents + advisory verifier (scripts/check_pipeline_integrity.py). Deterministic PreToolUse hook + multi-phase envelope deferred to v3.10 active conductor (#134).


Socratic Mode: Guided Research Dialogue

5-layer dialogue guiding users from vague ideas to concrete research questions. Core principle: ⚠️ IRON RULE: Never give direct answers.

Layers: Clarification -> Assumption Probing -> Evidence/Reasoning -> Viewpoint/Perspective -> Implication/Consequence

See references/socratic_mode_protocol.md for the full 5-layer dialogue flow, management rules, and auto-end conditions.

Opt-in Reading Probe (v3.5.1)

Setting ARS_SOCRATIC_READING_PROBE=1 enables a one-time honesty probe during goal-oriented Socratic sessions. When the user cites a specific paper, the Mentor asks them to paraphrase one passage. Decline is logged without penalty. Default OFF. See agents/socratic_mentor_agent.md §"Optional Reading Probe Layer".


Systematic Review Mode

PRISMA 2020-compliant systematic review with optional meta-analysis. Follows 5-phase protocol: Protocol Registration -> Systematic Search -> Screening & Selection -> Data Extraction & RoB -> Synthesis & Reporting.

v3.4.0 compliance: systematic-review mode triggers compliance_agent at Stage 2.5 (Methods items) and Stage 4.5 (remaining items + RAISE 8-role matrix). PRISMA-trAIce Mandatory failures block the pipeline. See shared/compliance_checkpoint_protocol.md.

See references/systematic_review_protocol.md for full PRISMA pipeline, checkpoint rules, and meta-analysis procedures.


Operational Modes

ModeAgents ActiveOutputWord Count
full (default)All 9 core (excluding socratic_mentor, RoB, meta-analysis)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 BLOCKEDCritical integrity issue (not subject matter)Stop the user once to confirm; list issues + remediation path; overridable with recorded reasoning
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)

Optional post-research monitoring for new publications in the research area.

See references/literature_monitoring_strategies.md for setup instructions across academic databases.


Handoff Protocol: deep-research → academic-paper

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

  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"

academic-paper'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 academic-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/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
references/argumentation_reasoning_framework.mdCognitive framework for evaluating argument strength: Toulmin model, causal reasoning (Bradford Hill), inference to best explanation, epistemic status classificationsynthesis, devils_advocate, source_verification, socratic_mentor, research_architect
references/socratic_mode_protocol.mdFull 5-layer Socratic dialogue flow, management rules, auto-end conditionssocratic_mentor, research_question
references/systematic_review_protocol.mdFull PRISMA pipeline, checkpoint rules, meta-analysis proceduresrisk_of_bias, meta_analysis, bibliography, report_compiler
references/cross_agent_quality_definitions.mdPeer-reviewed source tiers, currency standards, severity definitionsall agents
references/changelog.mdFull version history—

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.mddeep-research full mode handoff to academic-paper
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
examples/idea_diversity_coverage_gap_advisory.md#257 Socratic wording-pattern + lit-review distributional-skew advisories

Output Language

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


Anti-Patterns

Explicit prohibitions to prevent common failure modes:

#Anti-PatternWhy It FailsCorrect Behavior
1Confirmation bias in source selectionOnly finding sources that support the hypothesisDevil's Advocate checkpoint must include counter-evidence search
2Cherry-picking evidenceCiting one supportive study while ignoring three contradicting onesReport the full evidence landscape including conflicting findings
3Vibe citingMixing elements from 2-3 real papers into a fabricated referenceEvery reference must be verified independently; mashup fabrication is the hardest to detect
4⚠️ IRON RULE: Treating "difficult to verify" as acceptableMarking a reference as "uncertain" instead of FAILGray zone = FAIL. If you cannot confirm it exists, it does not go in the report
5Skipping phasesJumping to synthesis before completing source verificationComplete each phase fully; Phase N output is Phase N+1 input
6Shallow Socratic modeGiving answers disguised as questions ("Wouldn't you say X is true?")Ask genuine questions that expose assumptions; never lead to predetermined conclusions
7Source tier inflationTreating a blog post as equivalent to a peer-reviewed journalApply evidence hierarchy strictly: Tier 1 (peer-reviewed) > Tier 2 (preprint) > Tier 3 (gray lit)

Quality Standards

  1. ⚠️ IRON RULE: Every claim must have a citation — no unsupported assertions
  2. Evidence hierarchy — meta-analyses > RCTs > cohort studies > case reports > expert opinion (field-neutral baseline; grading is discipline-relative — a source meeting its own field's gold standard can reach Grade A even at a low design level. See references/source_quality_hierarchy.md §Grading Rubric + §Field-Specific Adjustments)
  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 across all agents. ⚠️ IRON RULE: CRITICAL severity = issue that would invalidate a core conclusion or constitute academic misconduct. Requires immediate resolution.

See references/cross_agent_quality_definitions.md for full peer-reviewed source tiers, currency standards, and severity definitions.


Integration with Other Skills

This skill is domain-agnostic but can be combined with domain-specific skills:

deep-research + tw-hei-intelligence     -> Evidence-based HEI policy research
deep-research + report-to-website       -> Interactive research report
deep-research + podcast-script-generator -> Research podcast
deep-research + academic-paper          -> Full research-to-publication pipeline
deep-research (socratic) + academic-paper (plan) -> Guided research + paper planning
deep-research (systematic-review) + academic-paper -> PRISMA systematic review paper

Version Info

ItemContent
Skill Version2.9.4
Last Updated2026-05-18
MaintainerCheng-I Wu
Dependent Skillsacademic-paper v1.0+ (downstream)

Version History

See references/changelog.md for full version history.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.