Skip to main content
skill CX Codex

arxiv-search · yorkeccak — Claude Code skill: what it does, how to install

arxiv-search searches arXiv preprints across physics, math, and computer science using natural language via Valyu. Useful for tracking research before peer review.

MIT 1,100 installs ★ 64 updated 2026-10-04

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add yorkeccak/scientific-skills --skill arxiv-search -a claude-code
Open on GitHub

What arxiv-search does

This skill queries the Valyu semantic search API using plain language. Instead of returning abstracts alone, it delivers full paper texts along with figure links and relevance scores. You do not need to assemble complex API query parameters.

The tool runs via scripts/search and scripts/search.mjs. Node.js 18+ provides the runtime with native fetch, so no third-party packages are installed.

A Valyu API key is mandatory for every query. Without it, the search script stops and demands configuration. You configure access by passing your token to scripts/search setup <api-key>.

What it helps with

  • search arXiv preprints using plain language queries
  • retrieve full article contents alongside figure links
  • track machine learning and physics trends prior to peer review
  • inspect prior art across multidisciplinary scientific topics

Example prompts for the agent

  • Search arXiv for recent papers on large language model architectures
  • Find arXiv preprints discussing topological quantum computation with figures
  • Check arXiv for distributed systems consensus algorithms

How to install arxiv-search

1Skills CLI (Vercel)

npx skills add yorkeccak/scientific-skills --skill arxiv-search -a claude-code

2Manually: put the files in place

~/.claude/skills/arxiv-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/arxiv-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about arxiv-search

How to install arxiv-search in Claude Code?

Run npx skills add yorkeccak/scientific-skills --skill arxiv-search -a claude-code. The skill writes its instructions into ~/.claude/skills/arxiv-search/SKILL.md.

What does arxiv-search do?

It searches the arXiv archive through Valyu semantic search and outputs JSON containing full paper content, figure links, and relevance scores.

What is required to run arxiv-search?

You need Node.js 18 or higher and a Valyu API key. Save your token by running scripts/search setup <api-key>.

Source text

SKILL.md · MIT
---
name: arxiv-search
description: Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.
keywords:
  - arxiv
  - preprints
  - physics
  - mathematics
  - computer-science
  - ai-research
  - semantic-search
license: MIT
---


# arXiv Search

Search the complete arXiv database of preprints across physics, mathematics, computer science, and quantitative biology using natural language queries powered by Valyu's semantic search API.

## Why This Skill is Powerful

- **No API Parameter Parsing**: Just pass natural language queries directly - no need to construct complex search parameters
- **Semantic Search**: Understands the meaning of your query, not just keyword matching
- **Full-Text Access**: Returns complete article content, not just abstracts
- **Image Links**: Includes figures and images from papers
- **Comprehensive Coverage**: Access to all of arXiv's preprint archive across multiple disciplines

## Requirements

1. Node.js 18+ (uses built-in fetch)
2. Valyu API key from https://platform.valyu.ai ($10 free credits)

## CRITICAL: Script Path Resolution

The `scripts/search` commands in this documentation are relative to this skill's installation directory.

Before running any command, locate the script using:

```bash
ARXIV_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/arxiv-search/*/scripts/*" -type f 2>/dev/null | head -1)
```

Then use the full path for all commands:
```bash
$ARXIV_SCRIPT "quantum entanglement" 15
```

## API Key Setup Flow

When you run a search and receive `"setup_required": true`, follow this flow:

1. **Ask the user for their API key:**
   "To search arXiv, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"

2. **Once the user provides the key, run:**
   ```bash
   scripts/search setup <api-key>
   ```

3. **Retry the original search.**

### Example Flow:
```
User: Search arXiv for transformer architecture papers
→ Response: {"success": false, "setup_required": true, ...}
→ Claude asks: "Please provide your Valyu API key from https://platform.valyu.ai"
→ User: "val_abc123..."
→ Claude runs: scripts/search setup val_abc123...
→ Response: {"success": true, "type": "setup", ...}
→ Claude retries: scripts/search "transformer architecture papers" 10
→ Success!
```

## When to Use This Skill

- Searching preprints across physics, mathematics, and computer science
- Finding research before peer review publication
- Cross-disciplinary research combining fields
- Staying current with rapid developments in AI and theoretical physics
- Prior art searching for new ideas
- Tracking emerging research trends
## Output Format

```json
{
  "success": true,
  "type": "arxiv_search",
  "query": "quantum entanglement",
  "result_count": 10,
  "results": [
    {
      "title": "Article Title",
      "url": "https://arxiv.org/abs/...",
      "content": "Full article text with figures...",
      "source": "arxiv",
      "relevance_score": 0.95,
      "images": ["https://example.com/figure1.jpg"]
    }
  ],
  "cost": 0.025
}
```

## Processing Results

### With jq

```bash
# Get article titles
scripts/search "query" 10 | jq -r '.results[].title'

# Get URLs
scripts/search "query" 10 | jq -r '.results[].url'

# Extract full content
scripts/search "query" 10 | jq -r '.results[].content'
```

## Common Use Cases

### AI/ML Research

```bash
# Find recent machine learning papers
scripts/search "large language model architectures" 50
```

### Physics Research

```bash
# Search for quantum physics papers
scripts/search "topological quantum computation" 20
```

### Mathematics

```bash
# Find math papers
scripts/search "representation theory and Lie algebras" 15
```

### Computer Science

```bash
# Search for CS theory papers
scripts/search "distributed systems consensus algorithms" 25
```


## Error Handling

All commands return JSON with `success` field:

```json
{
  "success": false,
  "error": "Error message"
}
```

Exit codes:
- `0` - Success
- `1` - Error (check JSON for details)

## API Endpoint

- Base URL: `https://api.valyu.ai/v1`
- Endpoint: `/search`
- Authentication: X-API-Key header

## Architecture

```
scripts/
├── search          # Bash wrapper
└── search.mjs      # Node.js CLI
```

Direct API calls using Node.js built-in `fetch()`, zero external dependencies.

## Adding to Your Project

If you're building an AI project and want to integrate arXiv Search directly into your application, use the Valyu SDK:

### Python Integration

```python
from valyu import Valyu

client = Valyu(api_key="your-api-key")

response = client.search(
    query="your search query here",
    included_sources=["valyu/valyu-arxiv"],
    max_results=20
)

for result in response["results"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")
```

### TypeScript Integration

```typescript
import { Valyu } from "valyu-js";

const client = new Valyu("your-api-key");

const response = await client.search({
  query: "your search query here",
  includedSources: ["valyu/valyu-arxiv"],
  maxResults: 20
});

response.results.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});
```

See the [Valyu docs](https://docs.valyu.ai) for full integration examples and SDK reference.

© yorkeccak · MIT · yorkeccak/scientific-skills

Similar skills

All skills for Science and research →

arxiv-search by other authors comes first.

arxiv-search spring-ai-alibaba arxiv-search searches arXiv for preprints and returns titles with abstracts. Handy when you need papers that have not reached a journal yet. CX Codex +1 1installs literature-search-arxiv google-deepmind literature-search-arxiv searches arXiv for papers and preprints, returns metadata and abstracts, and downloads full text as PDF, HTML or LaTeX source. CX Codex +1 3,700installs research-engineer davila7 Turns Claude Code into a strict research engineer focused on scientific rigor and complete runnable code without placeholders. CX Codex +1 333installs read-arxiv-paper karpathy The read-arxiv-paper skill reads an arXiv paper from its source files and writes a Markdown report. It is useful when research needs to be connected to nanochat. CX Codex +1 2,900installs arxiv Hermes Agent Searches arXiv by keyword, author, category or ID and pulls paper metadata through the free REST API. Handy when you need a citation or a BibTeX entry fast. CX Codex +1 748installs paper2code-arxiv-implementation reason-machines paper2code-arxiv-implementation converts arXiv papers into working Python code anchored to equations and sections. It audits ambiguities and flags missing paper details before execution. CX Codex +1 643installs pp-arxiv Hiten Shah pp-arxiv — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that connects to the public arXiv Atom API to search and fetch preprint metadata. No API key needed. CX Codex +1 407installs

From the same set13

The whole set →
biomedical-search biomedical-search is a Claude Code skill that searches biomedical literature, clinical trials, and FDA drug labels through Valyu. Activate it for evidence gathering across research sources. CX Codex +1 738installs pubmed-search pubmed-search is a Claude Code skill for natural-language semantic search across PubMed. It returns full article texts and figures for literature reviews. CX Codex +1 711installs patents-search patents-search searches patents worldwide from plain-language queries. Useful for prior art, technology landscapes and tracking what competitors file. CX Codex +1 641installs literature-search literature-search — a Claude Code skill that queries PubMed, arXiv, bioRxiv and medRxiv together using plain-language phrases. One command returns full texts, figures and relevance scores from all four databases. CX Codex +1 605installs medrxiv-search medrxiv-search is a Claude Code skill that searches medRxiv medical preprints with plain-language queries and retrieves full article text. It supports searches for clinical and epidemiological research. CX Codex +1 196installs clinical-trials-search clinical-trials-search searches ClinicalTrials.gov using natural language queries via Valyu semantic search API. CX Codex +1 174installs drug-discovery-search drug-discovery-search is a Claude Code skill for natural-language searches of compounds, targets, and drug information. It supports target research, compound optimization, and safety assessment. CX Codex +1 169installs biorxiv-search biorxiv-search is a Claude Code skill that searches bioRxiv preprints using natural-language queries. It returns full texts, figures, and relevance scores. CX Codex +1 150installs

Project sponsors

Companies that keep this analytics open