Agent skill

Orcid API

by wentorai in wentorai/research-plugins

Look up researcher profiles and academic identities via the ORCID registry

MITAuto-check passedBackend & APIs

Install Orcid API

skills CLI
$ npx skills add wentorai/research-plugins --skill orcid-api -a claude-code

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

GitHub CLI
$ gh skill install wentorai/research-plugins orcid-api --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/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature/metadata/orcid-api .claude/skills/orcid-api && 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
orcid-api
GitHub stars
298
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
449 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Look up researcher profiles and academic identities via the ORCID registry

  • Backend & APIs work in your project
  • SKILL.md covers Overview, Authentication, Core Endpoints and Rate Limits, plus 3 more sections
  • Calls curl and jq; reaches pub.orcid.org and orcid.org

What it does

Orcid API is an agent skill from wentorai/research-plugins. Look up researcher profiles and academic identities via the ORCID registry

Its SKILL.md is about 1.5k 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 Backend & APIs. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/orcid-api”

Requirements

  • A credential in ORCID_ACCESS_TOKEN
  • A credential in YOUR_CLIENT_SECRET

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • curl
    • jq

    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:

    • pub.orcid.org
    • orcid.org

    Also links to:

    • info.orcid.org

    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

Orcid API loads about 1.5k tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 449 words of instructions outside code blocks.

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

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 wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 449 words, ~1,478 tokens.

Download SKILL.mdSave it as .claude/skills/orcid-api/SKILL.md (or your agent's skills folder).
name
orcid-api
description
Look up researcher profiles and academic identities via the ORCID registry

ORCID API Guide

Overview

ORCID (Open Researcher and Contributor ID) is a nonprofit organization that provides unique, persistent digital identifiers to researchers worldwide. With over 18 million registered researchers, ORCID has become the standard for disambiguating author identities across the scholarly ecosystem. Publishers, funders, and institutions use ORCID to reliably connect researchers with their works, grants, and affiliations.

The ORCID Public API provides read access to public data in ORCID records. This includes biographical information, employment history, education, works (publications), funding, and peer review activities. The API is essential for building research information systems, verifying researcher identities, and integrating with institutional repositories.

Authentication is required. The public API uses OAuth 2.0 with a client credentials grant, which provides a bearer token for read-only access to public data. Registration is free and tokens can be obtained programmatically.

Authentication

The ORCID Public API requires an OAuth 2.0 access token. Register for free API credentials at https://orcid.org/developer-tools and obtain a token:

bash
curl -X POST "https://orcid.org/oauth/token" \
  -H "Accept: application/json" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  -d "scope=/read-public"

Include the token in all API requests:

Authorization: Bearer YOUR_ACCESS_TOKEN

Tokens are long-lived (typically 20 years) and can be reused across sessions.

Core Endpoints

Record: Retrieve Full ORCID Profile
  • URL: GET https://pub.orcid.org/v3.0/{orcid-id}/record
  • Parameters:
    ParamTypeRequiredDescription
    orcid-idstringYesThe 16-digit ORCID iD (e.g., 0000-0002-1825-0097)
    AcceptheaderNoResponse format: application/json, application/xml
  • Example:
    bash
    curl -H "Authorization: Bearer YOUR_TOKEN" \
         -H "Accept: application/json" \
         "https://pub.orcid.org/v3.0/0000-0002-1825-0097/record"
  • Response: JSON with complete ORCID record including person (name, biography, emails, addresses), activities-summary (works, funding, employment, education, peer reviews).
Works: Retrieve Publication List
  • URL: GET https://pub.orcid.org/v3.0/{orcid-id}/works
  • Parameters:
    ParamTypeRequiredDescription
    orcid-idstringYesThe ORCID iD
  • Example:
    bash
    curl -H "Authorization: Bearer YOUR_TOKEN" \
         -H "Accept: application/json" \
         "https://pub.orcid.org/v3.0/0000-0002-1825-0097/works"
  • Response: JSON with group array of work summaries, each containing title, external-ids (DOI, PMID, etc.), type, publication-date, and journal-title.
Show full SKILL.md (193 more words)Show less
Search: Find Researchers
  • URL: GET https://pub.orcid.org/v3.0/search
  • Parameters:
    ParamTypeRequiredDescription
    qstringYesLucene query syntax (e.g., family-name:Einstein, affiliation-org-name:MIT)
    startintegerNoPagination offset (default: 0)
    rowsintegerNoResults per page (default: 100, max: 200)
  • Example:
    bash
    curl -H "Authorization: Bearer YOUR_TOKEN" \
         -H "Accept: application/json" \
         "https://pub.orcid.org/v3.0/search?q=family-name:Hinton+AND+affiliation-org-name:Toronto&rows=10"
  • Response: JSON with result array containing orcid-identifier (ORCID iD and URI) for each matching researcher.

Rate Limits

The public API allows 24 requests per second and 40 burst requests. The member API has higher limits. If limits are exceeded, the API returns HTTP 503 with a Retry-After header. For bulk data access, ORCID provides annual data dumps and a Lambda file for incremental updates. Rate limits apply per access token.

Common Patterns

Verify Researcher Identity

Confirm that a researcher's ORCID is valid and retrieve their public profile:

bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     "https://pub.orcid.org/v3.0/0000-0001-5109-3700/person"
Build a Complete Publication List

Retrieve all works associated with an ORCID profile and extract DOIs:

bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     "https://pub.orcid.org/v3.0/0000-0002-1825-0097/works" | jq '.group[].work-summary[0] | {title: .title.title.value, doi: (.["external-ids"]["external-id"][] | select(.["external-id-type"] == "doi") | .["external-id-value"])}'
Find Researchers at an Institution

Search for ORCID profiles affiliated with a specific organization:

bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     "https://pub.orcid.org/v3.0/search?q=affiliation-org-name:Stanford+AND+current-institution-affiliation-name:Stanford&rows=50"

References

See Also

  • orcid-integration-guide -- Setting up your ORCID profile, publisher/funder integrations, and best practices for maintaining your record.

© wentorai, 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/literature/metadata/orcid-api of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Orcid API 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.

Orcid API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Orcid API this skillwentorai/research-plugins2981 repos~1.5kAutomated safety check: PassMIT
Jobskeli-wen/agy-staff727—~2.7kAutomated safety check: PassMIT
Tech Decisionteam-attention/plugins-for-claude-natives8273 repos~1.2kAutomated safety check: PassMIT
Octo SummaryMininglamp-OSS/octo-cli918—~1kAutomated safety check: PassApache-2.0
Customs Trade Law Onur Kafkaslawve-ai/awesome-legal-skills8361 repos~4.1kAutomated safety check: PassAGPL-3.0
Goosetown Researcher GitHubaaif-goose/goosetown154—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Jobs

    keli-wen/agy-staff

    Manage agy staffer background jobs - collect results, check status, cancel, follow-up conversation, and setup.

    727 GitHub stars~2.7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Tech Decision

    team-attention/plugins-for-claude-natives

    This skill should be used when the user asks to "기술 의사결정", "뭐 쓸지 고민", "A vs B", "비교 분석", "라이브러리 선택", "아키텍처 결정", "어떤 걸 써야 할지", "트레이드오프", "기술 선택", "구현 방식 고민", or needs deep analysis for technical…

    827 GitHub starsUsed in 3 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Octo Summary

    Mininglamp-OSS/octo-cli

    Read, create, find, and cite Octo summaries through octo-cli.

    918 GitHub stars~1k tokensUpdated 9 days ago
    Backend & APIsAuto-check passed
  • Customs Trade Law Onur Kafkas

    lawve-ai/awesome-legal-skills

    U.S. An agent skill from lawve-ai/awesome-legal-skills.

    836 GitHub starsUsed in 1 repo~4.1k tokens
    Backend & APIsAuto-check passed
  • Goosetown Researcher GitHub

    aaif-goose/goosetown

    Search GitHub issues, PRs, code, and discussions using the gh CLI.

    154 GitHub stars~1.6k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Stage 3 of the spatial transcriptomics workflow — identify spatial domains and detect spatially variable genes.

    101 GitHub stars~476 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Categories

Questions about Orcid API

What does Orcid API do?

Look up researcher profiles and academic identities via the ORCID registry. Orcid API is an agent skill from wentorai/research-plugins.

When should I use Orcid API?

Orcid API fits situations like: backend & APIs work in your project.

How do I install Orcid API in Claude Code?

Run `npx skills add wentorai/research-plugins --skill orcid-api -a claude-code`. Or copy the skill folder (skills/literature/metadata/orcid-api in wentorai/research-plugins) into .claude/skills/orcid-api in your project. Claude Code loads it when a task matches its description.

How do I install Orcid API in Codex?

Run `npx skills add wentorai/research-plugins --skill orcid-api -a codex`. Or copy the skill folder (skills/literature/metadata/orcid-api in wentorai/research-plugins) into .agents/skills/orcid-api in your project. Codex loads it when a task matches its description.

Can I use Orcid API 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 wentorai/research-plugins --skill orcid-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/orcid-api, .gemini/skills/orcid-api, .github/skills/orcid-api and .opencode/skills/orcid-api in your project.

What does Orcid API need to run?

Going by SKILL.md and its folder, Orcid API needs the command-line tools its instructions call (curl and jq). Our summary lists: A credential in ORCID_ACCESS_TOKEN; A credential in YOUR_CLIENT_SECRET.

Does Orcid API access the network?

SKILL.md names 3 domains. In commands or code: pub.orcid.org and orcid.org; the agent is likely to contact these when it follows the instructions. As links in the text: info.orcid.org. This is read from the text; nothing was executed.

Is Orcid API 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 Orcid API use?

Orcid API 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 Orcid API use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Orcid API?

Skills that share tags, products or a category with Orcid API: Jobs (keli-wen/agy-staff, 727 stars), Tech Decision (team-attention/plugins-for-claude-natives, 827 stars), Octo Summary (Mininglamp-OSS/octo-cli, 918 stars) and Customs Trade Law Onur Kafkas (lawve-ai/awesome-legal-skills, 836 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Orcid API?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

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