Agent skill

Openalex

by AI4Scientist in AI4Scientist/nano-scientist

Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information.

No licenceAuto-check: notesResearch & Science

Install Openalex

skills CLI
$ npx skills add AI4Scientist/nano-scientist --skill openalex -a claude-code

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

GitHub CLI
$ gh skill install AI4Scientist/nano-scientist openalex --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/AI4Scientist/nano-scientist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openalex .claude/skills/openalex && 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
openalex
GitHub stars
128
Used in
2 other repos
Token cost
~2.1k tokens
SKILL.md length
750 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
None found

At a glance

Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information.

  • Works in 6 steps: Parse Arguments → Locate Script → Execute Search → …
  • User says openalex search
  • SKILL.md covers Role & Positioning, Constants, Setup and Workflow, plus 2 more sections
  • Calls python3 and pip; needs OPENALEX_API_KEY

What it does

Openalex is an agent skill from AI4Scientist/nano-scientist. Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information. Use when user says "openalex search", "search openalex", "open citation graph", or wants comprehensive academic metadata beyond arXiv/Semantic Scholar.

Its SKILL.md is about 2.1k 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. It works with arXiv and Semantic Scholar. The repository describes itself as: An autonomous research agent that turns a topic into a peer-reviewed technical report.

When your agent uses it

  • User says openalex search
  • Search openalex
  • Open citation graph
  • Wants comprehensive academic metadata beyond arXiv/Semantic Scholar

Example prompts

  • “openalex search”
  • “search openalex”
  • “open citation graph”
  • “/openalex”

Requirements

  • Python 3
  • A credential in OPENALEX_API_KEY
  • Pre-approved tools (allowed-tools): Bash(*), Read, Write

Workflow steps

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

  1. Parse Arguments
  2. Locate Script
  3. Execute Search
  4. Parse Results
  5. Present Results
  6. Offer Follow-up

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3
    • pip

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

  • Network

    Links to these hosts (documentation or services it may open):

    • openalex.org

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENALEX_API_KEY

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

Context cost

Openalex loads about 2.1k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 750 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:58
    **Optional: API keys** — Create `.claude/.env` in project root:
  • NoteMentions a .env fileSKILL.md:61
    cp .claude/.env.example .claude/.env
  • NoteMentions a .env fileSKILL.md:64
    # .claude/.env
  • NoteMentions a .env fileSKILL.md:69
    Claude Code automatically loads `.claude/.env` as environment variables.
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Write

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 750 words (~2,055 tokens).

name
openalex
allowed-tools
Bash(*), Read, Write
argument-hint
search-query

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/openalex of AI4Scientist/nano-scientist.

Open the folder on GitHubat commit 7132192

Used in 2 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AI4Scientist/nano-scientist, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Openalex 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.

Openalex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openalex this skillAI4Scientist/nano-scientist1282 repos~2.1kAutomated safety check: NotesNone
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Paper Research on arXivXiaomiMiMo/MiMo-Code14k—~1.5kAutomated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT
Literature Review AgentAr9av/PaperOrchestra6771 repos~5.2kAutomated safety check: PassCustom licence
Nature Academic Searchwp-a/nature-academic-search301—~1.4kAutomated safety check: PassMIT

Similar skills

  • 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
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub stars~1.5k tokensUpdated today
    Research & ScienceAuto-check passed
  • 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 7 days ago
    Research & ScienceAuto-check: notes
  • Literature Review Agent

    Ar9av/PaperOrchestra

    Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.

    677 GitHub starsUsed in 1 repo~5.2k tokens
    Research & ScienceAuto-check passed
  • Nature Academic Search

    wp-a/nature-academic-search

    A skill your agent uses when users ask to 找文献、做文献检索、查论文、查临床试验、核验引用、去重文献、设计 PubMed/MeSH 检索式、追踪上下游引文、解析 DOI/PMID/PMCID/arXiv/OpenAlex/Semantic Scholar/NCT ID, 或导出 RIS、BibTeX、NBIB、ENW;also use for…

    301 GitHub stars~1.4k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • PaperSeek Literature Search

    MingfengHong/paperseek

    Routes literature searches through the PaperSeek launcher, picks suitable scholarly sources, parses JSON output and keeps API keys out of the chat.

    200 GitHub stars~1.6k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed

More from AI4Scientist/nano-scientist

All 74 skills in this repo
  • Formula Derivation

    AI4Scientist/nano-scientist

    Structures and derives research formulas when the user wants to 推导公式, build a theory line, organize assumptions, turn scattered equations into a coherent derivation, or rewrite theory notes into a…

    128 GitHub starsUsed in 5 repos~2.3k tokens
    Auto-check passed
  • Paper Compile

    AI4Scientist/nano-scientist

    Compile LaTeX paper to PDF, fix errors, and verify output. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~2.5k tokens
    Auto-check: notes
  • Paper Figure

    AI4Scientist/nano-scientist

    Generate publication-quality figures and tables from experiment results.

    128 GitHub starsUsed in 5 repos~2.9k tokens
    Auto-check: notes
  • Paper Navigator

    AI4Scientist/nano-scientist

    Find and read academic papers: disambiguate queries, discover papers (search, citation traversal, recommendations, arXiv monitoring, trending, GitHub search), evaluate (TLDR, citations, code, SOTA)…

    128 GitHub stars~7.7k tokensUpdated 4 mo ago
    Auto-check: notes
  • Proof Writer

    AI4Scientist/nano-scientist

    Writes rigorous mathematical proofs for ML/AI theory. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Ablation Planner

    AI4Scientist/nano-scientist

    A skill your agent uses when main results pass result-to-claim (claimsupported=yes or partial) and ablation studies are needed for paper submission.

    128 GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check: notes

Questions about Openalex

What does Openalex do?

Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information. Openalex is an agent skill from AI4Scientist/nano-scientist. Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information.

When should I use Openalex?

Openalex fits situations like: user says openalex search; search openalex; open citation graph; wants comprehensive academic metadata beyond arXiv/Semantic Scholar.

How do I install Openalex in Claude Code?

Run `npx skills add AI4Scientist/nano-scientist --skill openalex -a claude-code`. Or copy the skill folder (skills/openalex in AI4Scientist/nano-scientist) into .claude/skills/openalex in your project. Claude Code loads it when a task matches its description.

How do I install Openalex in Codex?

Run `npx skills add AI4Scientist/nano-scientist --skill openalex -a codex`. Or copy the skill folder (skills/openalex in AI4Scientist/nano-scientist) into .agents/skills/openalex in your project. Codex loads it when a task matches its description.

Can I use Openalex 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 AI4Scientist/nano-scientist --skill openalex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openalex, .gemini/skills/openalex, .github/skills/openalex and .opencode/skills/openalex in your project.

What does Openalex need to run?

Going by SKILL.md and its folder, Openalex needs the command-line tools its instructions call (python3 and pip) and credentials named OPENALEX_API_KEY. Our summary lists: Python 3; A credential in OPENALEX_API_KEY. Its frontmatter pre-approves these tools: Bash(*), Read, Write.

Does Openalex access the network?

SKILL.md names 1 domain. As links in the text: openalex.org. This is read from the text; nothing was executed.

Is Openalex safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Openalex use?

No licence was found for Openalex or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Openalex use?

About 2.1k tokens (SKILL.md is roughly 8.2k 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 Openalex?

Skills that share tags, products or a category with Openalex: Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Paper Research on arXiv (XiaomiMiMo/MiMo-Code, 14k stars), Paper Search (openags/paper-search-mcp, 2.8k stars) and Literature Review Agent (Ar9av/PaperOrchestra, 677 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openalex?

AI4Scientist (a GitHub organization) maintains it in AI4Scientist/nano-scientist, which has 128 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on June 3, 2026.

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