Agent skill

Gs Advanced Search

by cookjohn in cookjohn/gs-skills

Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only.

MITAuto-check passedResearch & Science

Install Gs Advanced Search

skills CLI
$ npx skills add cookjohn/gs-skills --skill gs-advanced-search -a claude-code

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

GitHub CLI
$ gh skill install cookjohn/gs-skills gs-advanced-search --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/cookjohn/gs-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gs-advanced-search .claude/skills/gs-advanced-search && 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
gs-advanced-search
GitHub stars
527
Token cost
~1.2k tokens
SKILL.md length
278 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only.

  • Works in 4 steps: Parse search criteria into URL parameters → Navigate → Extract results (evaluate_script) → …
  • Precise filtered searches
  • SKILL.md covers Arguments, Step 1: Parse search criteria…, Step 2: Navigate and Step 3: Extract results…, plus 2 more sections
  • Reaches scholar.google.com

What it does

Gs Advanced Search is an agent skill from cookjohn/gs-skills. Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only. Constructs proper URL parameters from natural language. Use for precise filtered searches.

Its SKILL.md is about 1.2k 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, covering Academic paper search. The repository describes itself as: Google Scholar skills for Claude Code — search, citation tracking, full-text access, and Zotero export via Chrome DevTools MCP. The licence is MIT.

When your agent uses it

  • Precise filtered searches
  • Tasks that involve Academic paper search

Example prompts

  • “/gs-advanced-search”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Parse search criteria into URL parameters
  2. Navigate
  3. Extract results (evaluate_script)
  4. Report

What it can do on your machine

Read from SKILL.md and the folder at commit df03c99. 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 javascript).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • scholar.google.com

    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

Gs Advanced Search loads about 1.2k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 278 words of instructions outside code blocks.

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

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 cookjohn/gs-skills at commit df03c99, republished under its MIT licence (© cookjohn). 278 words, ~1,197 tokens.

Download SKILL.mdSave it as .claude/skills/gs-advanced-search/SKILL.md (or your agent's skills folder).
name
gs-advanced-search
description
Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only. Constructs proper URL parameters from natural language. Use for precise filtered searches.
argument-hint
[describe search criteria in natural language]

Construct and execute a Google Scholar search using URL parameters based on the user's natural language description.

Arguments

$ARGUMENTS is a natural language description of the search criteria, e.g.:

  • "Search for Einstein's papers on relativity after 2020"
  • "Find reviews about CRISPR in Nature"
  • "Search for exact phrase 'machine learning' in title only"

Step 1: Parse search criteria into URL parameters

Map the user's intent to Google Scholar URL parameters:

CriteriaParameterExample
Keywordsqq=gastric+cancer
Authoras_sauthorsas_sauthors="Albert Einstein"
Journal/Sourceas_publicationas_publication=Nature
Start yearas_yloas_ylo=2020
End yearas_yhias_yhi=2025
Exact phraseas_epqas_epq=machine+learning
Any of these words (OR)as_oqas_oq=immunotherapy+checkpoint
Exclude wordsas_eqas_eq=review
Search scopeas_occtas_occt=title (title only) / as_occt=any (anywhere)
Results per pagenumnum=10 (default) or num=20 (max)
Languagehlhl=en or hl=zh-CN

Construction examples:

  • "Einstein 2020 年以后在 Nature 上的论文" → scholar?as_sauthors=Einstein&as_publication=Nature&as_ylo=2020&hl=en
  • "标题包含 CRISPR 的论文" → scholar?q=CRISPR&as_occt=title&hl=en
  • "精确搜索 'deep learning' 排除 review" → scholar?as_epq=deep+learning&as_eq=review&hl=en
  • "搜索 immunotherapy 或 checkpoint 相关论文" → scholar?as_oq=immunotherapy+checkpoint&hl=en

Notes:

  • When as_sauthors, as_publication, etc. are used, q can be omitted or used for additional keywords
  • Always include hl=en for consistent results
  • Use num=10 (default) to minimize CAPTCHA risk

Step 2: Navigate

Use mcp__chrome-devtools__navigate_page:

  • url: https://scholar.google.com/scholar?{CONSTRUCTED_PARAMS}

Step 3: Extract results (evaluate_script)

Same extraction script as gs-search step 2:

javascript
async () => {
  for (let i = 0; i < 20; i++) {
    if (document.querySelector('#gs_res_ccl') || document.querySelector('#gs_captcha_ccl')) break;
    await new Promise(r => setTimeout(r, 500));
  }

  if (document.querySelector('#gs_captcha_ccl') || document.body.innerText.includes('unusual traffic')) {
    return { error: 'captcha', message: 'Google Scholar requires CAPTCHA verification. Please complete it in your browser, then tell me to continue.' };
  }

  const items = document.querySelectorAll('#gs_res_ccl .gs_r.gs_or.gs_scl');
  const results = Array.from(items).map((item, i) => {
    const titleEl = item.querySelector('.gs_rt a');
    const meta = item.querySelector('.gs_a')?.textContent || '';
    const parts = meta.split(' - ');
    const authors = parts[0]?.trim() || '';
    const journalYear = parts[1]?.trim() || '';
    const citedByEl = item.querySelector('.gs_fl a[href*="cites"]');

    return {
      n: i + 1,
      title: titleEl?.textContent?.trim() || item.querySelector('.gs_rt')?.textContent?.trim() || '',
      href: titleEl?.href || '',
      authors,
      journalYear,
      citedBy: citedByEl?.textContent?.match(/\d+/)?.[0] || '0',
      citedByUrl: citedByEl?.href || '',
      dataCid: item.getAttribute('data-cid') || '',
      fullTextUrl: (item.querySelector('.gs_ggs a') || item.querySelector('.gs_or_ggsm a'))?.href || '',
      snippet: item.querySelector('.gs_rs')?.textContent?.trim()?.substring(0, 200) || ''
    };
  });

  const totalText = document.querySelector('#gs_ab_md')?.textContent?.trim() || '';
  const currentUrl = window.location.href;
  return { total: totalText, resultCount: results.length, currentUrl, results };
}

Step 4: Report

Advanced search on Google Scholar:
Query parameters: {list the parameters used}
{total}

1. {title}
   Authors: {authors} | {journalYear}
   Cited by: {citedBy} | [Full text]({fullTextUrl})
   Data-CID: {dataCid}

2. ...

Always show the constructed URL parameters so the user understands how the query was built.

Notes

  • This skill uses 2 tool calls: navigate_page + evaluate_script
  • Google Scholar does NOT support publication type filtering (review, clinical trial, etc.) — use keywords instead
  • Impact factor is not available in Google Scholar — use citation count as a proxy
  • The key difference from gs-search is URL parameter construction — this skill translates natural language to Google Scholar query parameters

© cookjohn, 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/gs-advanced-search of cookjohn/gs-skills.

Open the folder on GitHubat commit df03c99

Compare with similar skills

Gs Advanced Search 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.

Gs Advanced Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gs Advanced Search this skillcookjohn/gs-skills527—~1.2kAutomated safety check: PassMIT
Read arXiv Paperkarpathy/nanochat59k1 repos~494Automated safety check: PassMIT
Perplexity Web Searchdavila7/claude-code-templates33k11 repos~3.5kAutomated safety check: NotesMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12612 repos~3kAutomated safety check: PassCustom licence
Citation ManagementK-Dense-AI/claude-scientific-writer2.4k2 repos~3.9kAutomated safety check: NotesMIT

Similar skills

  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    59k GitHub starsUsed in 1 repo~494 tokens
    Research & ScienceAuto-check passed
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    33k GitHub starsUsed in 11 repos~3.5k tokens
    Research & ScienceAuto-check: notes
  • 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 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 12 repos~3k tokens
    Research & ScienceAuto-check passed
  • 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 2 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Preprint Search on bioRxiv

    LigphiDonk/Oh-my--paper

    Searches bioRxiv life sciences preprints by keyword, author, date range or category with a Python script, returning JSON metadata and optional PDF downloads.

    739 GitHub starsUsed in 12 repos~3.7k tokens
    Research & ScienceAuto-check passed

More from cookjohn/gs-skills

  • Gs Cited By

    cookjohn/gs-skills

    Find papers that cite a given Google Scholar paper. An agent skill from cookjohn/gs-skills.

    527 GitHub stars~935 tokensUpdated 7 mo ago
    Auto-check passed
  • Gs Export

    cookjohn/gs-skills

    Export Google Scholar paper(s) to Zotero via BibTeX. An agent skill from cookjohn/gs-skills.

    527 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Gs Fulltext

    cookjohn/gs-skills

    Get full-text access links for a Google Scholar paper - PDF, DOI, Sci-Hub, and publisher links.

    527 GitHub stars~1.1k tokensUpdated 7 mo ago
    Auto-check passed
  • Gs Navigate Pages

    cookjohn/gs-skills

    Navigate Google Scholar search result pages. An agent skill from cookjohn/gs-skills.

    527 GitHub stars~901 tokensUpdated 7 mo ago
    Auto-check passed
  • Gs Search

    cookjohn/gs-skills

    Search Google Scholar for academic papers by keywords. An agent skill from cookjohn/gs-skills.

    527 GitHub stars~1k tokensUpdated 7 mo ago
    Auto-check passed

Questions about Gs Advanced Search

What does Gs Advanced Search do?

Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only. Gs Advanced Search is an agent skill from cookjohn/gs-skills. Perform advanced Google Scholar search with filters - author, journal, date range, exact phrase, title-only.

When should I use Gs Advanced Search?

Gs Advanced Search fits situations like: precise filtered searches; tasks that involve Academic paper search.

How do I install Gs Advanced Search in Claude Code?

Run `npx skills add cookjohn/gs-skills --skill gs-advanced-search -a claude-code`. Or copy the skill folder (skills/gs-advanced-search in cookjohn/gs-skills) into .claude/skills/gs-advanced-search in your project. Claude Code loads it when a task matches its description.

How do I install Gs Advanced Search in Codex?

Run `npx skills add cookjohn/gs-skills --skill gs-advanced-search -a codex`. Or copy the skill folder (skills/gs-advanced-search in cookjohn/gs-skills) into .agents/skills/gs-advanced-search in your project. Codex loads it when a task matches its description.

Can I use Gs Advanced Search 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 cookjohn/gs-skills --skill gs-advanced-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gs-advanced-search, .gemini/skills/gs-advanced-search, .github/skills/gs-advanced-search and .opencode/skills/gs-advanced-search in your project.

What does Gs Advanced Search need to run?

SKILL.md names no scripts, command-line tools or credentials: Gs Advanced Search is instructions for the agent only.

Does Gs Advanced Search access the network?

SKILL.md names 1 domain. In commands or code: scholar.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Gs Advanced Search 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 Gs Advanced Search use?

Gs Advanced Search 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 Gs Advanced Search use?

About 1.2k tokens (SKILL.md is roughly 4.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 Gs Advanced Search?

Skills that share tags, products or a category with Gs Advanced Search: Read arXiv Paper (karpathy/nanochat, 59k stars), Perplexity Web Search (davila7/claude-code-templates, 33k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars) and Openalex Database (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 Gs Advanced Search?

cookjohn (a GitHub user) maintains it in cookjohn/gs-skills, which has 527 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on March 13, 2026.

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