skills/25-HosungYou-Diverga/skills/b1/SKILL.md
VS-Enhanced Literature Review Strategist - Comprehensive support for multiple review methodologies Full VS 5-Phase process: Prevents Mode Collapse and presents creative search strategies Supports: Systematic Review (PRISMA 2020), Scoping Review (JBI/PRISMA-ScR), Meta-Synthesis, Realist Synthesis, Narrative Review, Rapid Review Use when: conducting any type of literature review, systematic reviews, meta-analyses, scoping reviews, finding prior research Triggers: literature review, PRISMA, systematic review, scoping review, meta-synthesis, realist synthesis, narrative review, rapid review
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research b1Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
diverga_check_prerequisites("b1") → must return approved: true
If not approved → AskUserQuestion for each missing checkpoint (see .claude/references/checkpoint-templates.md)
diverga_mark_checkpoint("CP_SCREENING_CRITERIA", decision, rationale)diverga_mark_checkpoint("CP_SEARCH_STRATEGY", decision, rationale)diverga_mark_checkpoint("CP_VS_001", decision, rationale)Read .research/decision-log.yaml directly to verify prerequisites. Conversation history is last resort.
Agent ID: 05 (formerly B1-Systematic Literature Scout) Category: B - Literature & Evidence VS Level: Full (5-Phase) Tier: Core Icon: 📚
Develops and executes comprehensive literature search strategies for multiple review methodologies. Applies VS-Research methodology to avoid monotonous strategies like "search PubMed only," proposing comprehensive and reproducible search strategies tailored to review type.
This agent supports 6 major literature review methodologies:
| Review Type | Standard/Framework | Purpose | Timeline | |-------------|-------------------|---------|----------| | Systematic Review | PRISMA 2020 | Intervention effectiveness, policy evidence synthesis | 6-12 months | | Scoping Review | JBI Scoping Review, PRISMA-ScR | Research area mapping, gap identification, concept clarification | 4-8 months | | Meta-Synthesis | Noblit & Hare (Meta-ethnography), Thematic synthesis | Qualitative research integration, theory development | 8-12 months | | Realist Synthesis | RAMESES standard | Complex intervention context-mechanism-outcome analysis | 8-14 months | | Narrative Review | Traditional, Critical, Integrative | Theory development, concept clarification, critical analysis | 3-6 months | | Rapid Review | Accelerated PRISMA | Time-constrained policy decisions, urgent evidence needs | 2-4 weeks |
Must collect before VS application:
Required Context:
- review_type: "systematic_review | scoping_review | meta_synthesis | realist_synthesis | narrative_review | rapid_review"
- research_question: "Refined research question"
- key_concepts: "Main keyword list"
Optional Context:
- inclusion_criteria: "Year, language, study type"
- exclusion_criteria: "Study types to exclude"
- target_journal: "Target journal level"
- timeline_constraint: "For rapid reviews"
- theoretical_framework: "For realist synthesis"
Review-Type Specific Triggers:
| Review Type | Trigger Keywords | |-------------|------------------| | Systematic Review | "PRISMA", "systematic review", "meta-analysis", "intervention effectiveness" | | Scoping Review | "scoping review", "map the literature", "research gap", "JBI", "PRISMA-ScR" | | Meta-Synthesis | "meta-synthesis", "meta-ethnography", "qualitative synthesis", "Noblit & Hare" | | Realist Synthesis | "realist synthesis", "CMO", "context-mechanism-outcome", "RAMESES" | | Narrative Review | "narrative review", "literature review", "critical review", "integrative review" | | Rapid Review | "rapid review", "urgent", "quick turnaround", "2-4 weeks" |
Purpose: Explicitly identify the most predictable "obvious" search strategies and improve upon them
Review-Type Specific Modal Warnings:
## Phase 1: Modal Search Strategy Identification (Systematic Review)
⚠️ **Modal Warning**: The following are the most common incomplete search strategies:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| Single DB (PubMed only) | 0.95 | Low recall, field bias |
| Keywords only | 0.90 | Missing synonyms |
| Title/abstract only | 0.88 | Missing relevant literature |
| No citation tracking | 0.85 | Missing key literature |
| English-only | 0.83 | Language bias |
➡️ This is the baseline. We will develop more comprehensive strategies.
## Phase 1: Modal Search Strategy Identification (Scoping Review)
⚠️ **Modal Warning**: Common incomplete scoping review searches:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| Too narrow scope | 0.92 | Defeats scoping purpose |
| No iterative refinement | 0.88 | Missing emerging themes |
| Systematic review approach | 0.85 | Over-rigorous for scoping |
| No concept clarification | 0.82 | Unclear scope boundaries |
➡️ Scoping reviews require breadth and flexibility.
## Phase 1: Modal Search Strategy Identification (Meta-Synthesis)
⚠️ **Modal Warning**: Common incomplete meta-synthesis searches:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| Quantitative DB focus | 0.93 | Missing qualitative studies |
| No method filters | 0.90 | Low precision |
| Exhaustive search attempt | 0.87 | Purposive sampling more appropriate |
| No conceptual saturation | 0.84 | Incomplete thematic coverage |
➡️ Meta-synthesis requires targeted qualitative literature search.
## Phase 1: Modal Search Strategy Identification (Realist Synthesis)
⚠️ **Modal Warning**: Common incomplete realist synthesis searches:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| Exhaustive search | 0.94 | Inefficient for theory-driven approach |
| No CMO framing | 0.91 | Missing mechanistic insights |
| Empirical studies only | 0.88 | Missing theoretical literature |
| Linear search | 0.85 | Should be iterative |
➡️ Realist synthesis requires iterative, theory-driven search.
## Phase 1: Modal Search Strategy Identification (Narrative Review)
⚠️ **Modal Warning**: Common incomplete narrative review searches:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| No clear scope | 0.96 | Arbitrary selection |
| Cherry-picking | 0.93 | Confirmation bias |
| Outdated sources | 0.89 | Missing recent advances |
| No critical analysis | 0.86 | Descriptive only |
➡️ Narrative reviews still require logical structure and critical analysis.
## Phase 1: Modal Search Strategy Identification (Rapid Review)
⚠️ **Modal Warning**: Common rapid review pitfalls:
| Modal Strategy | T-Score | Problem |
|---------------|---------|---------|
| Too comprehensive | 0.94 | Defeats rapid purpose |
| Single reviewer, no verification | 0.91 | High risk of errors |
| No transparency about shortcuts | 0.88 | Misleading rigor claims |
| No date limits | 0.85 | Unmanageable volume |
➡️ Rapid reviews require smart shortcuts with transparent reporting.
Purpose: Present search strategies at 3 levels based on T-Score
## Phase 2: Long-Tail Strategy Sampling
**Direction A** (T ≈ 0.6): Multi-database + Boolean
- 3-5 academic DBs + Boolean operator combinations
- Advantages: Standard but comprehensive
- Suitable for: General systematic reviews
**Direction B** (T ≈ 0.4): Comprehensive strategy + Supplementary search
- Multi-DB + Citation tracking + Grey literature
- Advantages: PRISMA criteria compliant
- Suitable for: Meta-analyses, top-tier journals
**Direction C** (T < 0.25): Innovative search strategy
- AI-assisted screening + Semantic search + Living review
- Advantages: Latest methodology application
- Suitable for: Methodological innovation papers
Purpose: Select strategy appropriate for research type and journal level
Selection Criteria:
Purpose: Develop selected strategy in detail
## Phase 4: Search Strategy Execution
### Database-Specific Search Strings
[Present specific search strings]
### Supplementary Searches
[Citation tracking, Grey literature, etc.]
### PRISMA Flowchart
[Document search results]
Purpose: Confirm final strategy is sufficiently comprehensive
## Phase 5: Comprehensiveness Verification
✅ Modal Avoidance Check:
- [ ] Not searching single DB only? → YES
- [ ] Included citation tracking? → YES
- [ ] Considered grey literature? → YES
✅ Quality Check:
- [ ] PRISMA 2020 criteria compliant? → YES
- [ ] Search process reproducible? → YES
- [ ] All major synonyms included? → YES
T > 0.8 (Modal - Extension Needed):
├── Single database search
├── Keywords only
├── Title/abstract only
├── English literature only
└── No citation tracking
T 0.5-0.8 (Established - Supplement):
├── 2-3 databases
├── Boolean operators used
├── Some MeSH/Thesaurus use
├── Last 10 years limitation
└── Basic inclusion/exclusion criteria
T 0.3-0.5 (Comprehensive - Recommended):
├── 5+ databases
├── Forward/Backward citation tracking
├── Expert consultation
├── Grey literature included
├── Multilingual search considered
└── Search string peer review
T < 0.3 (Innovative - For Methodology Papers):
├── Semantic search tools used
├── AI-assisted screening
├── Living review methodology
├── Text mining pre-exploration
└── Novel search methodology development
Standard: PRISMA 2020 Statement Purpose: Synthesize evidence for intervention effectiveness, policy decisions, clinical guidelines Search Requirements:
Quality Indicators:
Standard: JBI Scoping Review Manual, PRISMA-ScR Purpose: Map research landscape, identify gaps, clarify concepts Search Requirements:
Key Differences from Systematic Review:
Approaches:
Purpose: Integrate qualitative research findings, develop new theoretical insights Search Requirements:
Quality Indicators:
Standard: RAMESES (Realist And Meta-narrative Evidence Syntheses: Evolving Standards) Purpose: Understand how, why, and under what circumstances complex interventions work Search Requirements:
Framework:
Quality Indicators:
Types:
Purpose: Theory development, concept clarification, critical analysis Search Requirements:
Quality Indicators:
Purpose: Urgent policy decisions, timely evidence needs (e.g., pandemic response) Timeline: 2-4 weeks (vs. 6-12 months for systematic review) Search Requirements:
Acceptable Shortcuts:
Caution: Trade-offs between speed and comprehensiveness must be transparent
Required:
- review_type: "systematic_review | scoping_review | meta_synthesis | realist_synthesis | narrative_review | rapid_review"
- research_question: "Refined research question"
- key_concepts: "Main keyword list"
Optional:
- inclusion_criteria: "Year, language, study type"
- exclusion_criteria: "Study types to exclude"
- specific_databases: "Priority databases to search"
- timeline: "Urgency level (for rapid reviews)"
- quality_appraisal: "Required or not (for scoping reviews)"
## Systematic Literature Search Strategy (VS-Enhanced)
---
### Phase 1: Modal Search Strategy Identification
⚠️ **Modal Warning**: The following are common incomplete searches in this field:
| Modal Strategy | T-Score | Problem in This Study |
|---------------|---------|----------------------|
| [Strategy1] | 0.95 | [Specific problem] |
| [Strategy2] | 0.90 | [Specific problem] |
➡️ This is the baseline. We will develop more comprehensive strategies.
---
### Phase 2: Long-Tail Strategy Sampling
**Direction A** (T = 0.60): Multi-DB + Boolean
- Databases: [List]
- Supplement: MeSH/Thesaurus
- Suitable for: [Journal level]
**Direction B** (T = 0.38): Comprehensive PRISMA Compliant
- Databases: [Extended list]
- Supplement: Citation tracking, Grey lit
- Suitable for: [Journal level]
**Direction C** (T = 0.22): Innovative Strategy
- Additional: AI screening, Semantic search
- Suitable for: [Journal level]
---
### Phase 3: Low-Typicality Selection
**Selection**: Direction [B] - Comprehensive PRISMA Compliant (T = 0.38)
**Selection Rationale**:
1. Appropriate comprehensiveness for [research type]
2. Full PRISMA 2020 compliance
3. Resource-efficient
---
### Phase 4: Search Strategy Execution
#### 1. PICO(S)-Based Search Structure
| Element | Concept | Search Terms |
|---------|---------|--------------|
| Population | [Target] | term1 OR term2 OR term3 |
| Intervention | [Intervention] | term1 OR term2 |
| Comparison | [Comparison] | term1 OR term2 |
| Outcome | [Outcome] | term1 OR term2 |
**Combined Search String:**
(Population terms) AND (Intervention terms) AND (Outcome terms)
#### 2. Search Term Development
##### Concept 1: [Concept Name]
| Type | Terms |
|------|-------|
| Core terms | [term] |
| Synonyms | [term1, term2] |
| Related terms | [term] |
| MeSH/Thesaurus | [term] |
| Truncation | [term*] |
##### Concept 2: [Concept Name]
[Same format]
#### 3. Database-Specific Search Strategies
##### Semantic Scholar (API Available)
Search string: [Optimized search string] Filters: year >= [year], open_access = true API endpoint: /graph/v1/paper/search
##### OpenAlex (API Available)
Search string: [Optimized search string] Filters: from_publication_date:[year] API endpoint: /works
##### PubMed
Search string: [Optimized search string] Filters: [Applied filters]
##### PsycINFO / ERIC
Search string: [Optimized search string] Thesaurus: [Applied terms]
##### arXiv (100% OA)
Search string: [Optimized search string] Categories: [Relevant categories]
#### 4. Grey Literature Search Plan
| Source | Search Method | Status |
|--------|--------------|--------|
| ProQuest Dissertations | [Method] | ⬜ |
| Conference Proceedings | [Method] | ⬜ |
| OSF Preprints | [Method] | ⬜ |
| Google Scholar (supplement) | [Method] | ⬜ |
#### 5. Supplementary Search Strategies
##### Citation Tracking
- **Forward**: Start from [key paper list]
- **Backward**: Review references of [key papers]
##### Key Author Search
- [Author1]: [ORCID / Google Scholar profile]
- [Author2]: [Search method]
##### Key Journal Hand Search
- [Journal1]: Last [N] years
- [Journal2]: Check special issues
#### 6. Search Results Documentation
| Database | Search Date | Search String | Results |
|----------|-------------|---------------|---------|
| Semantic Scholar | [Date] | [String] | [N] |
| OpenAlex | [Date] | [String] | [N] |
| PubMed | [Date] | [String] | [N] |
| | | **Total** | **[N]** |
#### 7. PRISMA 2020 Flowchart Draft
╔═══════════════════════════════════════════════════════════════╗ ║ IDENTIFICATION ║ ╟───────────────────────────────────────────────────────────────╢ ║ Records identified from databases (n = X) ║ ║ Semantic Scholar (n = ) ║ ║ OpenAlex (n = ) ║ ║ PubMed (n = ) ║ ║ Other databases (n = ) ║ ║ ║ ║ Records identified from other sources (n = X) ║ ║ Citation tracking (n = ) ║ ║ Grey literature (n = ) ║ ╠═══════════════════════════════════════════════════════════════╣ ║ SCREENING ║ ╟───────────────────────────────────────────────────────────────╢ ║ Records after duplicates removed (n = X) ║ ║ ↓ ║ ║ Records screened (n = X) ║ ║ → Records excluded (n = X) ║ ║ ↓ ║ ║ Reports sought for retrieval (n = X) ║ ║ → Reports not retrieved (n = X) ║ ╠═══════════════════════════════════════════════════════════════╣ ║ INCLUDED ║ ╟───────────────────────────────────────────────────────────────╢ ║ Reports assessed for eligibility (n = X) ║ ║ → Reports excluded with reasons (n = X) ║ ║ ↓ ║ ║ Studies included in review (n = X) ║ ║ Reports included in review (n = X) ║ ╚═══════════════════════════════════════════════════════════════╝
---
### Phase 5: Comprehensiveness Verification
✅ Modal Avoidance:
- [x] Searching 5+ databases
- [x] Citation tracking (Forward + Backward) included
- [x] Grey literature search plan included
✅ PRISMA 2020 Compliance:
- [x] Search strings fully documented
- [x] Results by database recorded
- [x] Reproducible procedures
✅ Quality Assurance:
- [x] MeSH/Thesaurus used
- [x] Boolean operators appropriately applied
- [x] Truncation (*) applied
| DB | API | Features | PDF Access | |----|-----|----------|------------| | Semantic Scholar | REST | Free, citation network | ~40% OA | | OpenAlex | REST | Free, comprehensive | ~50% OA | | arXiv | REST | Free, preprints | 100% |
| DB | Field | Thesaurus | |----|-------|-----------| | PubMed | Medicine/Life sciences | MeSH | | PsycINFO | Psychology | APA Thesaurus | | ERIC | Education | ERIC Descriptors |
When User is Unsure Which Review Type to Use:
Use this decision tree to guide selection:
START: "What is your primary goal?"
├─ "Test intervention effectiveness" → SYSTEMATIC REVIEW
│ └─ Quantitative synthesis → Add META-ANALYSIS
│
├─ "Map research landscape" → SCOPING REVIEW
│ ├─ Narrow, well-defined → Consider SYSTEMATIC REVIEW
│ └─ Broad, exploratory → SCOPING REVIEW
│
├─ "Understand lived experiences" → META-SYNTHESIS
│ ├─ Qualitative only → META-ETHNOGRAPHY
│ └─ Mixed methods → INTEGRATIVE REVIEW
│
├─ "Explain how/why interventions work" → REALIST SYNTHESIS
│ └─ Complex interventions in context → REALIST SYNTHESIS
│
├─ "Provide overview for teaching/conceptual clarity" → NARRATIVE REVIEW
│ ├─ Need rigor → Consider SCOPING REVIEW
│ └─ Theory-driven → NARRATIVE REVIEW
│
└─ "Urgent policy decision (< 1 month)" → RAPID REVIEW
└─ If time allows → Upgrade to SYSTEMATIC REVIEW
| Dimension | Systematic | Scoping | Meta-Synthesis | Realist | Narrative | Rapid | |-----------|-----------|---------|----------------|---------|-----------|-------| | Research Question | Focused | Broad | Experiential | Causal | Conceptual | Urgent | | Data Type | Quantitative | Any | Qualitative | Any | Any | Any | | Search Comprehensiveness | Exhaustive | Broad | Purposive | Iterative | Selective | Streamlined | | Quality Appraisal | Mandatory | Optional | Yes (CASP) | Contextual | No | Simplified | | Protocol Registration | Required | Recommended | No | No | No | No | | Dual Screening | Yes | Yes | No | No | No | Optional | | Timeline | 6-12m | 4-8m | 8-12m | 8-14m | 3-6m | 2-4w | | Reporting Standard | PRISMA 2020 | PRISMA-ScR | ENTREQ | RAMESES | None | PRISMA-RR |
This self-evaluation section must be included in all outputs.
---
## 🔍 Self-Critique
### Strengths
Advantages of this search strategy:
- [ ] {Major databases included}
- [ ] {Grey literature considered}
- [ ] {Reproducibility ensured}
### Weaknesses
Potential limitations:
- [ ] {Language bias possibility}: {Mitigation approach}
- [ ] {Database access limitations}: {Mitigation approach}
- [ ] {Search term optimization limits}: {Mitigation approach}
### Alternative Perspectives
Literature that might be missed:
- **Potential Omission 1**: "{Type of literature that might be missed}"
- **Supplementary Method**: "{Supplementary strategy}"
- **Potential Omission 2**: "{Type of literature that might be missed}"
- **Supplementary Method**: "{Supplementary strategy}"
### Improvement Suggestions
Suggestions for search strategy improvement:
1. {Additional database searches}
2. {Areas requiring expert consultation}
### Confidence Assessment
| Area | Confidence | Rationale |
|------|------------|-----------|
| Comprehensiveness (Recall) | {High/Medium/Low} | {Rationale} |
| Precision | {High/Medium/Low} | {Rationale} |
| PRISMA Compliance | {High/Medium/Low} | {Rationale} |
**Overall Confidence**: {Score}/100
---
This agent has FULL upgrade level, utilizing all 5 creativity mechanisms:
| Mechanism | Application Timing | Usage Example | |-----------|-------------------|---------------| | Forced Analogy | Phase 2 | Apply search strategy patterns from other fields by analogy | | Iterative Loop | Phase 2-4 | 4-round search term refinement cycle | | Semantic Distance | Phase 2 | Discover semantically distant keywords/synonyms | | Temporal Reframing | Phase 1-2 | Review research trends from historical/future perspectives | | Community Simulation | Phase 4-5 | Search feedback from 7 virtual researchers |
Applied Checkpoints:
- CP-INIT-002: Select creativity level
- CP-VS-001: Select search strategy direction (multiple)
- CP-VS-002: Innovative strategy warning
- CP-VS-003: Search strategy satisfaction confirmation
- CP-FA-001: Select analogy source field
- CP-SD-001: Keyword expansion distance threshold
- CP-TR-001: Select time perspective (historical/future)
- CP-CS-001: Select feedback personas
| Review Type | Reporting Guideline | Key Elements | |-------------|---------------------|--------------| | Systematic Review | PRISMA 2020 (27 items) | Protocol, search strategy, PRISMA diagram, risk of bias | | Scoping Review | PRISMA-ScR (22 items) | Rationale, eligibility criteria, charting process | | Meta-Synthesis | ENTREQ (21 items) | Synthesis approach, line-by-line coding, reflexivity | | Realist Synthesis | RAMESES (24 items) | Program theory, CMO configurations, stakeholder engagement | | Narrative Review | No standard checklist | Clear scope, logical organization, critical analysis | | Rapid Review | PRISMA-RR (adapted) | Shortcuts used, limitations, transparency |
User: "I want to do a systematic review on AI tutoring effectiveness"
Agent: [Detects: systematic_review]
→ Phase 0: Collect PICO
→ Phase 1: Modal warning (single DB)
→ Phase 2: Present A/B/C strategies (T=0.6/0.4/0.2)
→ Phase 3: Select comprehensive (T=0.4)
→ Phase 4: 5+ databases + citation + grey
→ Phase 5: PRISMA checklist verification
User: "스코핑 리뷰로 AI 교육 연구 지형도를 그리고 싶어"
Agent: [Detects: scoping_review]
→ Phase 0: Collect scope boundaries
→ Phase 1: Modal warning (too narrow)
→ Phase 2: Present breadth-focused strategies
→ Phase 3: Select iterative approach
→ Phase 4: 2-3 databases + exploratory
→ Phase 5: PRISMA-ScR checklist
User: "Conduct meta-ethnography on student experiences with AI"
Agent: [Detects: meta_synthesis]
→ Phase 0: Collect qualitative focus
→ Phase 1: Modal warning (quantitative DB)
→ Phase 2: Present purposive sampling strategies
→ Phase 3: Select thematic saturation approach
→ Phase 4: Qualitative filters + snowballing
→ Phase 5: ENTREQ checklist
User: "How do AI interventions work in different educational contexts?"
Agent: [Detects: realist_synthesis, CMO structure]
→ Phase 0: Collect program theory
→ Phase 1: Modal warning (exhaustive search)
→ Phase 2: Present iterative theory-driven strategies
→ Phase 3: Select snowballing + expert consultation
→ Phase 4: CMO-focused extraction
→ Phase 5: RAMESES checklist
../../research-coordinator/core/vs-engine.md../../research-coordinator/core/t-score-dynamic.md../../research-coordinator/references/creativity-mechanisms.md../../research-coordinator/core/project-state.md../../research-coordinator/core/pipeline-templates.md../../research-coordinator/core/integration-hub.md../../research-coordinator/core/guided-wizard.md../../research-coordinator/core/auto-documentation.mdtools
Show mcp-stata identity, connected tools, and status. Use when the user asks if mcp-stata is available, asks about access to the toolkit, or asks what Stata tools are connected.
tools
Activate when users mention Stata commands, .do files, regressions, econometrics, stored results, graphs, dataset inspection, replication, or Stata errors. Route the task through mcp-stata tools and the specialized research skills instead of treating it as plain text coding.
development
Build and review paper-ready regression, balance, and summary tables from Stata outputs. Use when the user needs a clean table for a draft, appendix, or coauthor share-out.
tools
Install, configure, update, or verify mcp-stata across Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and VS Code. Activate when users ask to set up the Stata toolkit or troubleshoot the installation.