Agent skill · Code Review & Quality

oma-scholar

Scholarly research companion using Knows sidecar spec (.knows.yaml). Generates, validates, reviews, queries, and compares structured research-paper sidecars, and fetches them from knows.academy. Use for academic literature search, survey synthesis, paper authoring assistance, and peer review with token-efficient claim/evidence/relation access.

first-flukegithub.com/first-flukeGitHub ↗
claude-codecodexcursorMIT
Install
npx skills add first-fluke/oh-my-agent --skill oma-scholar --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 9
SKILL.md size: 14 KB
Bundled scripts: none
Path: .agents/skills/oma-scholar/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,204
Language: TypeScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Scholar - Research Paper Sidecar Companion ## Scheduling ### Goal Search, fetch, generate, validate, analyze, review, and compare scholarly paper sidecars using the Knows `.knows.yaml` spec for token-efficient research workflows. ### Intent signature - User asks for academic literature search, sidecar generation, sidecar validation, paper claims/evidence summary, structural paper comparison, or peer review as sidecar. - User references Knows, `.knows.yaml`, knows.academy, OpenAlex, claims, evidence, relations, or paper sidecars. ### When to use - Reading research papers token-efficiently via Knows sidecars (~700 tokens for claims-only vs ~10K for full PDF) - Generating `.knows.yaml` sidecars from your own paper drafts, LaTeX, or research notes - Validating sidecar structure (rule-based) before sharing - Producing peer reviews as sidecars - Querying or summarizing existing sidecars - Structurally comparing two papers (claims, methods, evidence) - Searching/fetching sidecars from `knows.academy` (2026 papers only; current counts via `/api/proxy/jobs/stats`) ### When NOT to use - General web search or non-academic content -> use `oma-search` - Translating papers -> use `oma-translat

What's inside
Steps it walks through
  1. Scheduling
  2. Goal
  3. Intent signature
  4. When to use
  5. When NOT to use
  6. Expected inputs
  7. Expected outputs
  8. Dependencies
  9. Control-flow features
  10. Structural Flow
  11. Entry
  12. Scenes
  13. Transitions
  14. Failure and recovery
Ships with 8 files
  • config/scholar-config.yaml
  • resources/api-endpoints.md
  • resources/checklist.md
  • resources/execution-protocol.md
  • resources/fallback-providers.md
  • resources/setup-openalex.md
  • resources/sidecar-spec.md
  • resources/upstream-spec-cache.md
Commands it runs
oma scholar search "<query>"
oma scholar resolve "<title-or-doi>"
oma scholar get "<record-id-or-doi>"
oma scholar lint "<paper.knows.yaml>"
Hybrid search: knows first, OpenAlex fallback
oma scholar search "vision language action"
Cross-source resolve: figures out which source has the right paper
oma scholar resolve "Attention Is All You Need"
Get by id (knows record_id, OpenAlex W-id, DOI, arXiv:<id>, CorpusId:<n>)
oma scholar get "10.48550/arXiv.1706.03762"
More from oh-my-agent
All skills →
About this skill
What does the oma-scholar skill do?

Scholarly research companion using Knows sidecar spec (.knows.yaml). Generates, validates, reviews, queries, and compares structured research-paper sidecars, and fetches them from knows.academy. Use for academic literature search, survey synthesis, paper authoring assistance, and peer review with token-efficient claim/evidence/relation access.

How do I install it?

Run `npx skills add first-fluke/oh-my-agent --skill oma-scholar --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From first-fluke/oh-my-agent, a repository with 1,204 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going