gracefullight/pkgs / .agents/skills/oma-scholar
oma-scholar
UnverifiedSearch academic literature and generate, validate, or compare Knows paper sidecars. Use for claim/evidence analysis and literature synthesis.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.2 KB |
| config/scholar-config.yaml | config | 2.7 KB |
| resources/api-endpoints.md | markdown | 4.7 KB |
| resources/checklist.md | markdown | 3.8 KB |
| resources/execution-protocol.md | markdown | 9.0 KB |
| resources/fallback-providers.md | markdown | 6.0 KB |
| resources/setup-openalex.md | markdown | 2.5 KB |
| resources/sidecar-spec.md | markdown | 10.8 KB |
| resources/upstream-spec-cache.md | markdown | 43.7 KB |
resources/setup-openalex.md
View on GitHub# OpenAlex API Key Setup (Optional)
OpenAlex powers metadata enrichment during Generate mode by backfilling missing DOI, venue, and year from a vast academic catalog. **The skill works without a key**, but enrichment is skipped.
## When you need this
- You frequently generate sidecars from raw text/LaTeX where DOI is not visible
- You want DOI/venue auto-resolved from the title
- You hit anonymous rate limits ("$1/day" allowance exhausted)
## Free Tier (Generous)
Without any key, OpenAlex grants $1/day equivalent free quota:
- **Unlimited** single-entity lookups
- **10,000** list/filter calls per day
- **1,000** search calls per day
- **100** content downloads per day
For most users, anonymous use is enough.
## Get a Key (30 seconds)
1. Sign up: https://openalex.org/
2. Generate key: https://openalex.org/settings/api
3. Copy the key
## Configure
### Option A: Per-shell environment
```bash
export OPENALEX_API_KEY="your_key_here"
```
### Option B: Persisted in `~/.claude/.env` (recommended)
```bash
mkdir -p ~/.claude
echo 'OPENALEX_API_KEY=your_key_here' >> ~/.claude/.env
```
Some Claude Code setups source this file automatically; if not, source it from your shell rc:
```bash
echo '[ -f ~/.claude/.env ] && set -a && . ~/.claude/.env && set +a' >> ~/.zshrc
```
### Option C: Polite-pool email only (no key)
If you don't want to sign up but want priority, set just an email:
```bash
export OPENALEX_EMAIL="you@example.com"
```
This puts you in the "polite pool" with better latency, no key required.
## Verify
```bash
curl -s "https://api.openalex.org/works?search=attention+is+all+you+need&api_key=$OPENALEX_API_KEY" \
| head -c 500
```
A 200 response with JSON results means the key is live.
## Pricing Beyond Free Tier
OpenAlex uses pay-as-you-go past the daily free allowance, with no monthly subscription. Most academic users never exceed the free tier. See https://openalex.org/pricing for current rates.
## Skill Behavior
When this skill needs metadata enrichment:
1. Check `OPENALEX_API_KEY` env var
2. If set -> use authenticated calls
3. If not set, check `OPENALEX_EMAIL` -> anonymous polite-pool
4. If neither, fall back to anonymous calls
5. On 403/429 -> stop enrichment, tell user to set the key, leave fields omitted (anti-fabrication)
## Privacy
- The key (or email) is sent to OpenAlex servers as a query parameter
- No source paper content is sent to OpenAlex; only title/author search strings
- OpenAlex is operated by OurResearch (a non-profit); see their privacy policy at https://openalex.org/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |