Agent skill

Boolean Search Guide

by wentorai in wentorai/research-plugins

Master Boolean operators and advanced search syntax for academic databases

MITAuto-check passedResearch & Science

Install Boolean Search Guide

skills CLI
$ npx skills add wentorai/research-plugins --skill boolean-search-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins boolean-search-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature/search/boolean-search-guide .claude/skills/boolean-search-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
boolean-search-guide
GitHub stars
298
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
243 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Master Boolean operators and advanced search syntax for academic databases

  • Works in 4 steps: Proximity operators (NEAR, ADJ, W/n) → NOT → AND → …
  • Research & Science work in your project
  • SKILL.md covers Boolean Operator Fundamentals, Advanced Search Syntax, Building a Systematic Search… and Search Filters and Limits, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Boolean Search Guide is an agent skill from wentorai/research-plugins. Master Boolean operators and advanced search syntax for academic databases

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science. It works with PubMed. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/boolean-search-guide”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Proximity operators (NEAR, ADJ, W/n)
  2. NOT
  3. AND
  4. OR

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Boolean Search Guide loads about 1.5k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 243 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 243 words, ~1,460 tokens.

Download SKILL.mdSave it as .claude/skills/boolean-search-guide/SKILL.md (or your agent's skills folder).
name
boolean-search-guide
description
Master Boolean operators and advanced search syntax for academic databases

Boolean Search Guide

A skill for constructing precise, reproducible search queries using Boolean operators across major academic databases. Covers AND, OR, NOT logic, proximity operators, truncation, field codes, and strategies for building systematic search strings.

Boolean Operator Fundamentals

Core Operators
AND  — Narrows results. Both terms must appear.
       "machine learning" AND "drug discovery"

OR   — Broadens results. Either term may appear.
       "deep learning" OR "neural network"

NOT  — Excludes results. Removes records containing the term.
       cancer NOT "lung cancer"

()   — Groups terms to control evaluation order.
       (COVID-19 OR SARS-CoV-2) AND (vaccine OR vaccination)
Operator Precedence

Databases evaluate Boolean expressions in this order unless parentheses override:

  1. Proximity operators (NEAR, ADJ, W/n)
  2. NOT
  3. AND
  4. OR

Always use parentheses to make your intent explicit:

# Ambiguous (results depend on database precedence):
sleep disorders OR insomnia AND cognitive performance

# Clear (intended meaning explicit):
(sleep disorders OR insomnia) AND cognitive performance

Advanced Search Syntax

Truncation and Wildcards
*  — Truncation (unlimited characters)
     therap*  matches therapy, therapies, therapeutic, therapeutics

?  — Single-character wildcard
     wom?n  matches woman, women

$  — Optional character (some databases)
     behavio$r  matches behavior, behaviour
Proximity Operators by Database
DatabaseOperatorExampleMeaning
PubMedNot supported--Use phrase search instead
Web of ScienceNEAR/nclimate NEAR/3 adaptationWithin 3 words
ScopusW/ngene W/5 therapyWithin 5 words, ordered
ScopusPRE/ndrug PRE/3 resistanceFirst term precedes second
ProQuestN/n, P/npoverty N/5 educationWithin 5 words
EBSCONnmental N3 healthWithin 3 words
Field-Specific Searching
PubMed:
  "machine learning"[Title]
  "Smith J"[Author]
  "Nature"[Journal]
  "2020/01/01"[Date - Publication] : "2024/12/31"[Date - Publication]

Web of Science:
  TI=("deep learning")
  AU=(Smith, John)
  SO=(Nature)
  PY=(2020-2024)

Scopus:
  TITLE("deep learning")
  AUTH(Smith)
  SRCTITLE(Nature)
  PUBYEAR > 2019

Building a Systematic Search Strategy

PICO Framework for Query Construction
python
def build_pico_search(population: str, intervention: str,
                      comparison: str, outcome: str) -> str:
    """
    Construct a Boolean search string from PICO components.

    Args:
        population: Target population terms (OR-separated)
        intervention: Intervention terms (OR-separated)
        comparison: Comparator terms (OR-separated, may be empty)
        outcome: Outcome terms (OR-separated)

    Returns:
        Complete Boolean search string
    """
    blocks = []

    blocks.append(f"({population})")
    blocks.append(f"({intervention})")

    if comparison:
        blocks.append(f"({comparison})")

    blocks.append(f"({outcome})")

    return " AND ".join(blocks)


# Example: Effect of mindfulness on anxiety in college students
query = build_pico_search(
    population='"college students" OR "university students" OR undergraduates',
    intervention='mindfulness OR "mindfulness-based stress reduction" OR MBSR',
    comparison='"wait list" OR "waitlist" OR "usual care" OR "control group"',
    outcome='anxiety OR "generalized anxiety" OR GAD OR "anxiety symptoms"'
)
print(query)
Iterative Refinement Workflow
1. Identify key concepts from your research question
2. List synonyms, related terms, and variant spellings for each concept
3. Combine synonyms within each concept using OR
4. Connect concept blocks using AND
5. Test the search in your target database
6. Review the first 50 results for relevance
7. If recall is too low: add more synonyms, use truncation
8. If precision is too low: add more AND blocks, use field limits
9. Document the final search string with date and result count

Search Filters and Limits

Common Filters Across Databases
Language:        English, Chinese, Spanish, etc.
Date range:      Publication year or date added
Document type:   Journal article, review, conference paper
Study design:    RCT, cohort, case-control (PubMed clinical queries)
Species:         Human, animal (PubMed)
Open access:     Free full text available
PubMed Clinical Query Filters

PubMed provides validated search filters (hedges) for specific study types. Append these to your search:

# Therapy/Intervention (sensitive):
AND (randomized controlled trial[pt] OR controlled clinical trial[pt]
OR randomized[tiab] OR randomly[tiab] OR trial[tiab])

# Diagnosis (specific):
AND (sensitivity and specificity[MeSH] OR predictive value of tests[MeSH]
OR accuracy[tiab])

# Systematic Reviews:
AND (systematic review[pt] OR meta-analysis[pt] OR systematic[sb])

Documenting and Reproducing Searches

For systematic reviews and reproducible research, always record:

  • Database name and interface version
  • Date the search was executed
  • Complete search string with line numbers
  • Number of results retrieved
  • Any filters or limits applied
  • Name of the person who ran the search

Store search strategies in a version-controlled file alongside your project so they can be independently verified and updated.

© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/literature/search/boolean-search-guide of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Boolean Search Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Boolean Search Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Boolean Search Guide this skillwentorai/research-plugins2981 repos~1.5kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT
Citation ManagementK-Dense-AI/claude-scientific-writer2.4k3 repos~3.9kAutomated safety check: NotesMIT
Citation Managementneflibata-feng/MyArxiv-Agent12620 repos~8.1kAutomated safety check: NotesMIT
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT

Similar skills

  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Citation Management

    K-Dense-AI/claude-scientific-writer

    Finds papers in OpenAlex, PubMed and Google Scholar, turns DOIs, PMIDs and arXiv IDs into clean BibTeX, and validates citations for a manuscript or thesis.

    2.4k GitHub starsUsed in 3 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Citation Management

    neflibata-feng/MyArxiv-Agent

    Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.

    126 GitHub starsUsed in 20 repos~8.1k tokens
    Research & ScienceAuto-check: notes
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).

    2.8k GitHub stars~1.2k tokensUpdated 6 days ago
    Research & ScienceAuto-check: notes
  • Rival Search MCP

    damionrashford/RivalSearchMCP

    Deterministic deep research via RivalSearchMCP. An agent skill from damionrashford/RivalSearchMCP.

    132 GitHub starsUsed in 1 repo~796 tokens
    Research & ScienceAuto-check passed

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Questions about Boolean Search Guide

What does Boolean Search Guide do?

Master Boolean operators and advanced search syntax for academic databases. Boolean Search Guide is an agent skill from wentorai/research-plugins.

When should I use Boolean Search Guide?

Boolean Search Guide fits situations like: research & Science work in your project.

How do I install Boolean Search Guide in Claude Code?

Run `npx skills add wentorai/research-plugins --skill boolean-search-guide -a claude-code`. Or copy the skill folder (skills/literature/search/boolean-search-guide in wentorai/research-plugins) into .claude/skills/boolean-search-guide in your project. Claude Code loads it when a task matches its description.

How do I install Boolean Search Guide in Codex?

Run `npx skills add wentorai/research-plugins --skill boolean-search-guide -a codex`. Or copy the skill folder (skills/literature/search/boolean-search-guide in wentorai/research-plugins) into .agents/skills/boolean-search-guide in your project. Codex loads it when a task matches its description.

Can I use Boolean Search Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill boolean-search-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/boolean-search-guide, .gemini/skills/boolean-search-guide, .github/skills/boolean-search-guide and .opencode/skills/boolean-search-guide in your project.

What does Boolean Search Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Boolean Search Guide is instructions for the agent only. Our summary lists: Python 3.

Does Boolean Search Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Boolean Search Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Boolean Search Guide use?

Boolean Search Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Boolean Search Guide use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Boolean Search Guide?

Skills that share tags, products or a category with Boolean Search Guide: Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Citation Management (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Citation Management (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Boolean Search Guide?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.