oma-scholar

Generates, validates, and queries Knows research-paper sidecars from papers and scholarly APIs.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill oma-scholar-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-scholar
Source: https://github.com/javiruu/viru-air/tree/main/.agents/skills/oma-scholar
Command: npx skills add https://github.com/javiruu/viru-air --skill oma-scholar-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reading full research papers costs thousands of tokens, and structuring claims, evidence, and citations by hand is slow and error-prone. This Skill produces and consumes compact .knows.yaml sidecars that expose a paper's claims, evidence, and relations in a validated, token-efficient format. ## Core Features & Use Cases - Sidecar Generation & Validation: Create v0.9.0 paper@1 sidecars from drafts, LaTeX, or abstracts, then lint them with oma scholar lint in strict or lenient modes. - Remote Search & Fetch: Search knows.academy (~50K indexed papers) with automatic OpenAlex fallback, and fetch full or partial sidecar sections (statements, evidence, relations, artifacts, citation) for up to 93% token savings. - Review, Analyze & Compare: Produce peer-review sidecars, answer natural-language questions over existing sidecars, and structurally diff two papers by claims, methods, and evidence. - Use Case: Ask for the claims of a specific arXiv paper; the Skill resolves it via knows.academy or OpenAlex, fetches only the statements section (~700 tokens), and summarizes each claim with its supporting evidence IDs. ## Quick Start Ask the assistant to search for papers on a topic or generate a .knows.yaml sidecar from your paper draft, for example: "Generate a Knows sidecar from my paper draft and lint it."

Frequently Asked Questions about oma-scholar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a .knows.yaml sidecar from my paper?▼

Provide your paper draft, LaTeX, abstract, or research notes and ask for sidecar generation. The Skill extracts claims, evidence, and relations into a v0.9.0 sidecar, then runs oma scholar lint to validate it before reporting counts and any omitted fields.

How do I search academic papers with knows.academy and OpenAlex?▼

Run oma scholar search with your query; it queries knows.academy first and automatically falls back to OpenAlex for pre-2026 or non-indexed papers. Use oma scholar resolve for a specific title or oma scholar get with a record ID, DOI, or OpenAlex W-id.

Can I fetch only the claims of a paper without the full sidecar?▼

Yes, partial fetch retrieves a single section such as statements, evidence, relations, artifacts, or citation via oma scholar get --section statements. A statements-only fetch is roughly 700 tokens, about 93% smaller than the full PDF.

Why does sidecar lint fail with field name or actor type errors?▼

The v0.9.0 spec requires exact field names like statement_type, evidence_type, predicate, and artifact_type, and actor type must be tool, person, or org, never ai or llm. Numbers must be unquoted and provenance uses a single actor object, not an actors array.

Does this work for papers published before 2026?▼

knows.academy indexes only 2026 papers, so older works automatically fall back to OpenAlex for metadata and abstracts. You can then generate a local sidecar from the OpenAlex abstract using Generate mode.

When should I use lenient lint mode on a sidecar?▼

Use --lenient when consuming third-party sidecars fetched from knows.academy, since about 47% contain dangling cross-references. Lenient mode downgrades dangling reference errors to warnings; keep strict mode for your own generated output.