# Openalex Pyalex

> Incubating Butler wrapper spec for upstream 'OpenAlex plus PyAlex'.

- Skill: `ocean326/openalex-pyalex` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ocean326/openalex-pyalex`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ocean326/openalex-pyalex/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: ocean326 (https://skillmd.com/u/ocean326)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ocean326/openalex-pyalex

---

# OpenAlex plus PyAlex

## Status

- `incubating`
- 这不是生产可执行 skill，而是 Butler 对外部上游的包装草案。
- 默认不得加入 `chat_default` / `codex_default` / `automation_safe`。

## Proposed Butler Shape

- institution and author lookup, work graph traversal, topic and concept monitoring

## Upstream

- repo_or_entry: https://github.com/J535D165/pyalex
- docs: https://docs.openalex.org/
- upstream_type: official_api_with_client
- maturity: high

## Why This Matters

- Broad and modern scholarly graph with practical Python wrapper support.
- Best candidate when Butler needs research landscape mapping, not just single-paper lookup.

## Risks

- Recent API-key changes mean Butler should centralize credentials and retry policy.
- Result richness can increase prompt noise if not post-filtered.

## Suggested Future Exposure

- skill_ops
- automation_safe

## Implementation Checklist

- 明确 Butler 输入输出 contract，不直接复刻上游 API。
- 确认认证、限流、缓存和错误恢复策略。
- 补执行脚本或 tool bridge，而不是只停留在说明文档。
- 补测试与 `skill-pool-verify` / `skill-pool-maintain` 校验。
- 审阅后再决定是否加入 collection registry。