Skip to content
academic-search logo

Academic Search Skill

academic-search

Search academic paper repositories (arXiv, Semantic Scholar) for scholarly articles in physics, mathematics, computer science, quantitative biology, AI/ML, and related fields

SKILL.md

Full skill instructions

Academic Search Skill

This skill provides access to academic paper repositories, primarily arXiv, for searching scholarly articles. arXiv is a free distribution service and open-access archive for preprints in physics, mathematics, computer science, quantitative biology, quantitative finance, statistics, electrical engineering, systems science, and economics.

When to Use This Skill

Use this skill when you need to:

  • Find cutting-edge research: Access preprints and recent papers before formal journal publication
  • Search AI/​ML papers: Find machine learning, deep learning, and artificial intelligence research
  • Explore computational methods: Search for algorithms, theoretical frameworks, and mathematical foundations
  • Research interdisciplinary topics: Find papers spanning computer science, biology, physics, and mathematics
  • Gather literature reviews: Collect relevant papers for comprehensive topic overviews
  • Track state-of-the-art: Find the latest advances in rapidly evolving fields

Ideal Use Cases

ScenarioExample Query
Understanding new architectures"transformer attention mechanism"
Exploring applications"large language models code generation"
Finding benchmarks"image classification benchmark ImageNet"
Surveying methods"reinforcement learning robotics"
Technical deep-dives"backpropagation neural networks"

How to Use

The skill provides a Python script that searches arXiv and returns formatted results with titles and abstracts.

Basic Usage

Note: Always use the absolute path from your skills directory.

If running from a virtual environment:

.venv/​bin/​python [YOUR_SKILLS_DIR]/​academic-search/​arxiv_search.py "your search query"

Or for system Python:

python3 [YOUR_SKILLS_DIR]/​academic-search/​arxiv_search.py "your search query"

Replace [YOUR_SKILLS_DIR] with the absolute skills directory path from your system prompt.

Command-Line Arguments

ArgumentRequiredDefaultDescription
queryYes-The search query string
--max-papersNo10Maximum number of papers to retrieve
--output-formatNotextOutput format: text, json, or markdown

Examples

Search for transformer architecture papers:

python3 arxiv_search.py "attention is all you need transformer" --max-papers 5

Search for reinforcement learning papers:

python3 arxiv_search.py "deep reinforcement learning continuous control" --max-papers 10

Search for LLM papers with JSON output:

python3 arxiv_search.py "large language model reasoning" --output-format json

Search for specific author or topic:

python3 arxiv_search.py "author:Hinton deep learning"

Search in specific arXiv categories:

python3 arxiv_search.py "cat:cs.LG neural network pruning"

Step-by-Step Workflow

1. Formulate Your Query

  • Use specific, technical terms (e.g., "convolutional neural network image segmentation" not "AI for pictures")
  • Include key authors if known: author:Bengio
  • Specify arXiv categories for focused results: cat:cs.CL (Computation and Language)
  • Combine terms for intersection: "graph neural network" AND "molecular property"

2. Execute the Search

python3 [SKILLS_DIR]/​academic-search/​arxiv_search.py "your refined query" --max-papers 10

3. Review Results

The output includes:

  • Title: Full paper title
  • Authors: List of paper authors
  • Published: Publication date
  • arXiv ID: Unique identifier (useful for citing)
  • URL: Direct link to the paper
  • Summary: Abstract text

4. Iterate if Needed

  • Too many irrelevant results? Add more specific terms or use category filters
  • Too few results? Broaden the query or remove restrictive terms
  • Looking for recent work? arXiv sorts by relevance by default

5. Save and Synthesize

Save relevant findings to your research workspace for later synthesis:

research_workspace/
  papers/
    topic_findings.md

Output Formats

Text Format (Default)

================================================================================
Title: Attention Is All You Need
Authors: Ashish Vaswani, Noam Shazeer, Niki Parmar, ...
Published: 2017-06-12
arXiv ID: 1706.03762
URL: https://arxiv.org/​abs/​1706.03762
--------------------------------------------------------------------------------
Summary: The dominant sequence transduction models are based on complex
recurrent or convolutional neural networks...
================================================================================

JSON Format

{
  "query": "transformer attention",
  "total_results": 5,
  "papers": [
    {
      "title": "Attention Is All You Need",
      "authors": ["Ashish Vaswani", "Noam Shazeer", ...],
      "published": "2017-06-12",
      "arxiv_id": "1706.03762",
      "url": "https://arxiv.org/​abs/​1706.03762",
      "summary": "The dominant sequence transduction models..."
    }
  ]
}

Markdown Format

## Attention Is All You Need

**Authors:** Ashish Vaswani, Noam Shazeer, ...
**Published:** 2017-06-12
**arXiv ID:** [1706.03762](https://arxiv.org/​abs/​1706.03762)

### Abstract
The dominant sequence transduction models are based on complex...

arXiv Category Reference

Common categories for AI/​ML research:

CategoryDescription
cs.LGMachine Learning
cs.AIArtificial Intelligence
cs.CLComputation and Language (NLP)
cs.CVComputer Vision
cs.NENeural and Evolutionary Computing
cs.RORobotics
stat.MLMachine Learning (Statistics)
q-bioQuantitative Biology
math.OCOptimization and Control

Best Practices

Query Construction

  1. Be specific: "graph attention network node classification" > "graph neural network"
  2. Use quotation marks: For exact phrases: "self-supervised learning"
  3. Combine operators: cat:cs.CV AND "object detection" AND 2023
  4. Include variations: Search for both "LLM" and "large language model"

Research Workflow Integration

  1. Start broad, then narrow: Begin with general queries, refine based on initial results
  2. Track paper IDs: Save arXiv IDs for citing and revisiting
  3. Check references: Seminal papers often cite foundational work
  4. Note publication dates: Preprints may be superseded by updated versions

Limitations to Consider

  • Preprint status: Papers may not be peer-reviewed
  • Version updates: Check for newer versions (v2, v3, etc.)
  • Coverage gaps: Not all fields are well-represented on arXiv
  • Rate limiting: Avoid excessive rapid queries

Dependencies

This skill requires the arxiv Python package:

# Virtual environment (recommended)
.venv/​bin/​python -m pip install arxiv

# System-wide
python3 -m pip install arxiv

The script will detect if the package is missing and display installation instructions.

Troubleshooting

"Error: arxiv package not installed"

Install the arxiv package as shown in Dependencies section.

No results returned

  • Try broader search terms
  • Remove category restrictions
  • Check for typos in technical terms

Rate limiting errors

  • Wait a few seconds between queries
  • Reduce --max-papers value

Connection errors

  • Check internet connectivity
  • arXiv API may have temporary outages

Integration with Research Workflow

This skill works well with the web-research skill for comprehensive research:

  1. Use academic-search for foundational/​theoretical papers
  2. Use web-research for current implementations, tutorials, and practical guides
  3. Synthesize findings from both sources in your research report

Notes

  • arXiv is particularly strong for:
    • Computer Science (cs.*)
    • Physics (physics., hep-, cond-mat.*)
    • Mathematics (math.*)
    • Quantitative Biology (q-bio.*)
    • Statistics (stat.*)
  • Results are sorted by relevance by default
  • The arXiv API is free and requires no authentication
  • Consider checking cited papers for deeper understanding

More skills from diegosouzapw

accessibility logo
diegosouzapw/awesome-omni-skill

accessibility

Accessibility guidelines for VS Code features — covers accessibility help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts/status announcements, keyboard navigation, and ARIA labels/roles. Applies to both new interactive UI surfaces and updates to existing feature...

62 1
View
mermaid-diagrams logo
diegosouzapw/awesome-omni-skill

mermaid-diagrams

Mermaid diagram creation for flowcharts, sequences, ERDs, and more. Generate diagrams from text in markdown files. Use for documentation, architecture diagrams, and visual representations. Triggers on mermaid, flowchart, sequence diagram, ERD, entity relationship, gantt chart, pie chart, class di...

62 1
View
tauri2-react-rust logo
diegosouzapw/awesome-omni-skill

tauri2-react-rust

Guides development of cross-platform desktop apps with Tauri 2, TypeScript, React, and Rust. Use when building Tauri apps, implementing IPC, designing Rust backend or TypeScript/React frontend, when researching or cloning a website (open site, snapshot elements), when verifying local dev or built...

62 1
View
fp-ts-errors logo
diegosouzapw/awesome-omni-skill

fp-ts-errors

Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.

62 0
View
ring:pre-dev-research logo
diegosouzapw/awesome-omni-skill

ring:pre-dev-research

Gate 0 research phase for pre-dev workflow. Dispatches 3 parallel research agents to gather codebase patterns, external best practices, and framework documentation BEFORE creating PRD/TRD. Outputs research.md with file:line references.

62 0
View
create-assistant logo
diegosouzapw/awesome-omni-skill

create-assistant

Create and configure Vapi voice AI assistants with models, voices, transcribers, tools, hooks, and advanced settings. Use when building voice agents, phone bots, customer support assistants, or any conversational AI that handles phone or web calls.

62 0
View
codex-headless logo
diegosouzapw/awesome-omni-skill

codex-headless

Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.

62 0
View
social-media-scheduler logo
diegosouzapw/awesome-omni-skill

social-media-scheduler

Generate a full week of social media content for any topic. Outputs platform-optimized posts for Twitter/X, LinkedIn, and Instagram with hashtags and posting times.

62 0
View
Data Privacy Compliance logo
diegosouzapw/awesome-omni-skill

Data Privacy Compliance

Data privacy and regulatory compliance specialist for GDPR, CCPA, HIPAA, and international data protection laws. Use when implementing privacy controls, conducting data protection impact assessments, ensuring regulatory compliance, or managing data subject rights. Expert in consent management, da...

62 0
View
triple-review logo
diegosouzapw/awesome-omni-skill

triple-review

Reviews a task using the TRIPLE protocol, as the review agent.

62 0
View
Tech Stack & Architecture Decision logo
diegosouzapw/awesome-omni-skill

Tech Stack & Architecture Decision

Define and document the technology stack and architecture decisions for a project. Use when the user needs to choose a tech stack, make architecture decisions, define infrastructure choices, or document technology selections. Triggers on requests like "define the tech stack", "choose technologies...

62 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View