agentleFS
ethosagentethosagent/ethos/skills/research/arxiv/SKILL.md

arxiv

Skill22 starsChanged 9 days agoMITView on GitHub

Search arXiv papers via the Atom API, explore citation graphs via Semantic Scholar, retrieve BibTeX via DOI content-negotiation. Keyless — uses curl + a bundled stdlib-only Python script.

  • Installs packages

43 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use competitor-news-monitor, p5js and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • aivrarSkill

    competitor-news-monitor

    Watch named companies for material news; cited digests.

    Also in 7 projects that use this

  • mae616Skill

    p5js

    p5.js(クリエイティブコーディング)のProcessing由来「コードでスケッチ」思想を軸に、setup/drawループ・座標系・インタラクション・パフォーマンス最適化を整理する。p5.js、Processing、クリエイティブコーディング、ジェネラティブアート、インタラクティブ表現、ビジュアルプログラミング、Canvas描画、パーティクル、フラクタル、ノイズ表現に関する相談で必ず使うこと。ユーザーが「コードでアート」「動くビジュアル」「インタラクティブな描画」と言った場合にも適用する。

    Also in 13 projects that use this

  • Tommy-ywSkill

    songwriting-and-ai-music

    Songwriting craft, AI music generation prompts (Suno focus), parody/adaptation techniques, phonetic tricks, and lessons learned. These are tools and ideas, not rules. Break any of them when the art calls for it.

    Also in 12 projects that use this

  • john-data-chenSkill

    teams-meeting-pipeline

    Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.

    Also in 9 projects that use this

  • math-incSkill

    findmy

    Track Apple devices and AirTags via FindMy.app on macOS using AppleScript and screen capture.

    Also in 13 projects that use this

  • math-incSkill

    heartmula

    Set up and run HeartMuLa, the open-source music generation model family (Suno-like). Generates full songs from lyrics + tags with multilingual support.

    Also in 7 projects that use this

  • +1 more from math-inc

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 3 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 43 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Search arXiv for academic papers, explore citation graphs via Semantic Scholar, and retrieve BibTeX entries.

    line 27
  2. Distinctive:

    Rate limiting: Wait at least 3 seconds between requests.

    line 79
  3. Very specific:

    All responses are JSON. Use jq for quick extraction:

    line 149
  4. Distinctive:

    Use DOI content-negotiation to get properly formatted BibTeX:

    line 159
  5. Very specific:

    If you only have the arXiv ID, construct the DOI: 10.48550/arXiv.<id> (e.g., 10.48550/arXiv.2301.12345).

    line 167

“Common” is measured: kept by at least 6 in 10 of the 43 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

arXiv Paper Search & Citation Graph

Search arXiv for academic papers, explore citation graphs via Semantic Scholar, and retrieve BibTeX entries. Everything is keyless — no API keys, no accounts, no setup.

When to use this skill

  • Finding academic papers on a topic (search by title, author, category, or abstract keywords).
  • Exploring what a paper cites and what cites it (citation graph traversal).
  • Retrieving properly formatted BibTeX for a known paper.
  • Surveying recent work in a research area before writing a paper or proposal.

When NOT to use this skill

  • General web research — use web_search instead.
  • Finding blog posts, tutorials, or non-academic content.
  • Full-text reading of papers — this skill discovers and summarizes metadata; reading the PDF is a separate step.

arXiv Atom API

The arXiv API uses Atom XML. No authentication required.

Endpoint: http://export.arxiv.org/api/query

Query syntax:

PrefixSearchesExample
ti:Titleti:attention+mechanism
au:Authorau:vaswani
abs:Abstractabs:transformer+architecture
cat:Categorycat:cs.CL

Combine with boolean operators: AND, OR, ANDNOT.

# Papers about transformers in NLP
ti:transformer AND cat:cs.CL

# Papers by Vaswani about attention
au:vaswani AND ti:attention

# Recent diffusion model papers, excluding images
ti:diffusion AND cat:cs.LG ANDNOT abs:image

Sorting and pagination:

ParameterValuesDefault
sortByrelevance, lastUpdatedDate, submittedDaterelevance
sortOrderascending, descendingdescending
startinteger offset0
max_resultsinteger (max 100)10

Rate limiting: Wait at least 3 seconds between requests. The API will return HTTP 503 if you exceed this.

Raw curl example:

curl -s "http://export.arxiv.org/api/query?search_query=ti:transformer+AND+cat:cs.CL&sortBy=lastUpdatedDate&sortOrder=descending&max_results=5"

Using the bundled script

The bundled Python script parses the Atom XML and prints structured results:

python3 scripts/search_arxiv.py "ti:transformer AND cat:cs.CL" --max-results 5

Options:

  • First positional argument: the search query (arXiv query syntax).
  • --max-results N: number of results (default 10, max 100).
  • --sort-by: one of relevance, lastUpdatedDate, submittedDate (default lastUpdatedDate).

Output is one block per paper:

=== [1/5] ===
Title:    Attention Is All You Need
Authors:  Ashish Vaswani, Noam Shazeer, Niki Parmar, ...
arXiv ID: 1706.03762
Categories: cs.CL, cs.LG
Published: 2017-06-12
Abstract:  The dominant sequence transduction models are based on complex recurrent or convolutional neural networks...
PDF:      https://arxiv.org/pdf/1706.03762

The script is stdlib-only Python 3 (no pip install needed).

Semantic Scholar API

Keyless access. No authentication required for low-volume use.

Paper details

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:1706.03762?fields=title,authors,year,citationCount,references,citations"

Returns title, author list, year, citation count, and lists of references and citations.

Citations (papers that cite this one)

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:1706.03762/citations?fields=title,year,citationCount&limit=100"

References (papers this one cites)

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:1706.03762/references?fields=title,year,citationCount"

Paper recommendations

curl -s "https://api.semanticscholar.org/recommendations/v1/papers/forpaper/arXiv:1706.03762?fields=title,year,citationCount&limit=10"

Returns papers similar to the given one. Useful for expanding a literature survey.

Parsing Semantic Scholar responses

All responses are JSON. Use jq for quick extraction:

# Get the top 10 most-cited papers that cite "Attention Is All You Need"
curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:1706.03762/citations?fields=title,year,citationCount&limit=100" \
  | jq '[.data[].citingPaper | select(.citationCount != null)] | sort_by(-.citationCount) | .[0:10] | .[] | {title, year, citationCount}'

BibTeX retrieval

Use DOI content-negotiation to get properly formatted BibTeX:

curl -LH "Accept: application/x-bibtex" "https://doi.org/10.48550/arXiv.1706.03762"

This works for any paper with a DOI. arXiv papers have DOIs of the form 10.48550/arXiv.<id>.

If you only have the arXiv ID, construct the DOI: 10.48550/arXiv.<id> (e.g., 10.48550/arXiv.2301.12345).

arXiv ID format

Two formats exist:

StylePatternExampleEra
Old<archive>/<YYMMNNN>math/0601001Before 2007-04
NewYYMM.NNNNN2301.123452007-04 onward

Papers have versions: 2301.12345v1, 2301.12345v2, etc. The versionless ID (2301.12345) always resolves to the latest version.

For Semantic Scholar lookups, always use the versionless ID — arXiv:2301.12345, not arXiv:2301.12345v2.

Gotchas

  • Rate limiting: arXiv enforces a 3-second wait between API calls. The bundled script handles this for single queries, but if you make multiple calls in sequence, add sleep 3 between them.
  • Withdrawn papers: Withdrawn papers still appear in search results. Check the abstract for withdrawal notices. The presence of <arxiv:journal_ref> suggests the paper was published in a journal (good sign).
  • Semantic Scholar lag: Newly posted arXiv papers may not appear in Semantic Scholar for 2-3 days. If a paper is very recent, rely on arXiv metadata alone.
  • Search encoding: In URLs, spaces in query terms should be encoded as + (e.g., ti:attention+mechanism). The bundled script handles this automatically.
  • Max results cap: arXiv API caps at 100 results per request. For larger surveys, paginate using start and max_results.
  • Category codes: Common CS categories: cs.AI (artificial intelligence), cs.CL (computation and language / NLP), cs.CV (computer vision), cs.LG (machine learning), cs.CR (cryptography), cs.SE (software engineering). Full list at https://arxiv.org/category_taxonomy.

Adapted from NousResearch/hermes-agent (MIT)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.