oma-scholar

1# Scholar - Research Paper Sidecar Companion
2 
3## Scheduling
4 
5### Goal
6Search, fetch, generate, validate, analyze, review, and compare scholarly paper sidecars using the Knows `.knows.yaml` spec for token-efficient research workflows.
7 
8### Intent signature
9- User asks for academic literature search, sidecar generation, sidecar validation, paper claims/evidence summary, structural paper comparison, or peer review as sidecar.
10- User references Knows, `.knows.yaml`, knows.academy, OpenAlex, claims, evidence, relations, or paper sidecars.
11 
12### When to use
13 
14- Reading research papers token-efficiently via Knows sidecars (~700 tokens for claims-only vs ~10K for full PDF)
15- Generating `.knows.yaml` sidecars from your own paper drafts, LaTeX, or research notes
16- Validating sidecar structure (rule-based) before sharing
17- Producing peer reviews as sidecars
18- Querying or summarizing existing sidecars
19- Structurally comparing two papers (claims, methods, evidence)
20- Searching/fetching sidecars from `knows.academy` (2026 papers only; current counts via `/api/proxy/jobs/stats`)
21 
22### When NOT to use
23 
24- General web search or non-academic content -> use `oma-search`
25- Translating papers -> use `oma-translation`
26- PDF parsing only (no sidecar) -> use `oma-pdf`
27- Submitting sidecars back to knows.academy -> out of scope (host LLM only consumes/produces locally)
28- Full peer-review workflow with editor system -> out of scope
29 
30### Expected inputs
31…