skills/43-wentorai-research-plugins/skills/literature/search/systematic-search-strategy/SKILL.md
Construct rigorous systematic search strategies for literature reviews
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research systematic-search-strategyInstall 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.
A skill for designing and executing comprehensive, reproducible literature search strategies for systematic reviews, scoping reviews, and meta-analyses. Follows PRISMA 2020 guidelines and Cochrane Handbook best practices.
Structure your research question using PICO (or variants):
P - Population / Problem: Who or what is being studied?
I - Intervention / Exposure: What is the treatment or exposure?
C - Comparison: What is the alternative?
O - Outcome: What is being measured?
Variants:
PICOS: adds Study design
SPIDER: Sample, Phenomenon of Interest, Design, Evaluation, Research type
PCC: Population, Concept, Context (for scoping reviews)
def pico_to_search_blocks(pico: dict) -> dict:
"""
Convert a PICO question into search concept blocks.
Args:
pico: Dict with keys 'population', 'intervention', 'comparison', 'outcome'
Each value is a list of synonyms/related terms
Returns:
Search blocks ready for Boolean combination
"""
blocks = {}
for component, terms in pico.items():
# Expand each term with common variants
expanded = []
for term in terms:
expanded.append(f'"{term}"')
# Add truncation variants
if len(term) > 5:
expanded.append(f'{term.rstrip("s")}*') # basic stemming
blocks[component] = expanded
# Build final query: AND between blocks, OR within blocks
query_parts = []
for component, terms in blocks.items():
block = ' OR '.join(terms)
query_parts.append(f'({block})')
final_query = ' AND '.join(query_parts)
return {
'blocks': blocks,
'combined_query': final_query,
'n_concepts': len(blocks)
}
# Example: RQ: "Does mindfulness meditation reduce anxiety in college students?"
pico = {
'population': ['college students', 'university students', 'undergraduate students',
'higher education students'],
'intervention': ['mindfulness', 'mindfulness meditation', 'mindfulness-based stress reduction',
'MBSR', 'mindfulness-based cognitive therapy', 'MBCT'],
'outcome': ['anxiety', 'anxiety disorder', 'generalized anxiety', 'test anxiety',
'anxiety symptoms', 'state anxiety', 'trait anxiety']
}
result = pico_to_search_blocks(pico)
print(result['combined_query'])
def adapt_search_for_database(base_query: str, database: str) -> str:
"""
Adapt a base search string for different database syntaxes.
"""
adaptations = {
'pubmed': {
'truncation': '*',
'phrase': '"..."',
'proximity': None, # PubMed doesn't support proximity
'field_tags': {'title': '[ti]', 'abstract': '[tiab]', 'mesh': '[MeSH]'},
'notes': 'Add MeSH terms for each concept block'
},
'web_of_science': {
'truncation': '*',
'phrase': '"..."',
'proximity': 'NEAR/N',
'field_tags': {'title': 'TI=', 'topic': 'TS=', 'author': 'AU='},
'notes': 'Use TS= for topic search (title+abstract+keywords)'
},
'scopus': {
'truncation': '*',
'phrase': '"..."',
'proximity': 'W/N',
'field_tags': {'title': 'TITLE()', 'title_abs': 'TITLE-ABS-KEY()', 'author': 'AUTH()'},
'notes': 'Use TITLE-ABS-KEY() for comprehensive searching'
},
'psycinfo': {
'truncation': '*',
'phrase': '"..."',
'proximity': 'Nn',
'field_tags': {'title': 'TI', 'abstract': 'AB', 'thesaurus': 'DE'},
'notes': 'Use DE field for PsycINFO thesaurus terms'
}
}
db = adaptations.get(database.lower(), {})
adapted = base_query # Start with base query
return {
'database': database,
'query': adapted,
'syntax_notes': db.get('notes', ''),
'truncation': db.get('truncation', '*'),
'field_tags': db.get('field_tags', {})
}
Document every search completely:
search_documentation:
date_searched: "2026-03-09"
databases:
- name: "PubMed/MEDLINE"
interface: "PubMed.gov"
date_coverage: "1966-present"
search_string: |
(("college students"[tiab] OR "university students"[tiab])
AND ("mindfulness"[tiab] OR "MBSR"[tiab])
AND ("anxiety"[tiab] OR "anxiety disorders"[MeSH]))
results_count: 342
filters_applied: "English language; 2010-2026"
- name: "Web of Science"
interface: "Clarivate"
date_coverage: "1900-present"
search_string: |
TS=("college student*" OR "university student*")
AND TS=(mindfulness OR MBSR OR MBCT)
AND TS=(anxiety)
results_count: 287
filters_applied: "Article or Review; English; 2010-2026"
grey_literature:
- "ProQuest Dissertations (N=45)"
- "Google Scholar first 200 results"
- "OpenGrey (N=12)"
- "Hand-searched reference lists of included studies"
total_before_dedup: 686
total_after_dedup: 493
deduplication_tool: "Covidence"
def prisma_flow(records: dict) -> str:
"""Generate PRISMA 2020 flow diagram data."""
flow = f"""
IDENTIFICATION
Records from databases: {records['from_databases']}
Records from other sources: {records['from_other']}
Duplicates removed: {records['duplicates']}
Records after dedup: {records['from_databases'] + records['from_other'] - records['duplicates']}
SCREENING
Title/abstract screened: {records['screened']}
Excluded at title/abstract: {records['excluded_screening']}
Full-text assessed: {records['fulltext_assessed']}
Excluded at full-text: {records['excluded_fulltext']}
Reasons: {records.get('exclusion_reasons', 'See table')}
INCLUDED
Studies in qualitative synthesis: {records['included_qualitative']}
Studies in meta-analysis: {records.get('included_meta', 'N/A')}
"""
return flow
After initial search execution:
Document every modification to the search strategy with rationale to maintain transparency and reproducibility.
development
Conduct rigorous thematic analysis (TA) of qualitative data following Braun and Clarke's (2006) six-phase framework. Use whenever the user mentions 'thematic analysis', 'TA', 'Braun and Clarke', 'qualitative coding', 'identifying themes', or asks for help analysing interviews, focus groups, open-ended survey responses, or transcripts to identify patterns. Also trigger for questions about inductive vs theoretical coding, semantic vs latent themes, essentialist vs constructionist epistemology, building a thematic map, or writing up a qualitative findings section. Covers all six phases, the four upfront analytic decisions, the 15-point quality checklist, and the five common pitfalls. Produces a Word document write-up and an annotated thematic map. Does NOT cover IPA, grounded theory, discourse analysis, conversation analysis, or narrative analysis — use a different method for those.
development
Guide users through writing a systematic literature review (SLR) following the PRISMA 2020 framework. Use this skill whenever the user mentions 'systematic review', 'systematic literature review', 'SLR', 'PRISMA', 'PRISMA 2020', 'PRISMA flow diagram', 'PRISMA checklist', or asks for help writing, structuring, or auditing a literature review that follows reporting guidelines. Also trigger when the user asks about inclusion/exclusion criteria for a review, search strategies for databases like Scopus/WoS/PubMed, study selection processes, risk of bias assessment, or narrative synthesis for a review paper. This skill covers the full PRISMA 2020 checklist (27 items), produces a Word document manuscript in strict journal article format, generates an annotated PRISMA flow diagram, and enforces APA 7th Edition referencing throughout. It does NOT cover meta-analysis or statistical pooling. By Chuah Kee Man.
testing
Performs placebo-in-time sensitivity analysis with hierarchical null model and optional Bayesian assurance. Use when checking model robustness, verifying lack of pre-intervention effects, or estimating study power.
data-ai
Fit, summarize, plot, and interpret a chosen CausalPy experiment. Use after the causal method has been selected, including when configuring PyMC/sklearn models and scale-aware custom priors.