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.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable content with concrete commands and strong validation/troubleshooting guidance, undermined by abstract meta-framework scaffolding and references to resource files that are not bundled. The body earns its tokens mostly through commands and error-fix tables.

Suggestions

Trim the abstract scaffolding (SSL primitive table, Resource scope table, Scenes labels) that restates workflow concepts Claude already understands, keeping only the concrete mode/transition rows.

Either bundle the referenced resources/*.md files (execution-protocol, sidecar-spec, api-endpoints, checklist, fallback-providers, setup-openalex, upstream-spec-cache) or inline the essential rules so dangling references don't break navigation.

Move the detailed mode-by-mode execution steps currently deferred to execution-protocol.md into a short inline numbered sequence so the workflow is self-contained.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with concrete commands and tables, but the abstract SSL-primitive mapping, Scenes, and Resource-scope scaffolding (e.g., 'SELECT/READ/REQUEST/INFER', 'LOCAL_FS/NETWORK/PROCESS') add conceptual padding Claude does not need.	3 / 5
Actionability	Copy-paste-ready commands throughout — 'oma scholar search\|resolve\|get\|lint', curl examples, and a troubleshooting table mapping exact error strings like '[ERROR] *.value: numeric value '22' is quoted' to fixes — cover the common cases fully.	5 / 5
Workflow Clarity	Sequenced PREPARE→FINALIZE scenes with explicit validation checkpoints ('run lint before sharing', guardrail 13) and a failure/recovery block, but the detailed step-by-step is deferred to an external protocol file rather than inlined.	4 / 5
Progressive Disclosure	Sections are well-organized with a clearly listed References block pointing one level deep, but the referenced bundle files (resources/execution-protocol.md, sidecar-spec.md, etc.) are not actually present in the bundle, so navigation is incomplete.	3 / 5
	Total	15 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states concrete capabilities and an explicit 'Use for' trigger clause tied to a well-defined niche. Minor keyword synonym gaps prevent a perfect trigger_term_quality score.

Dimension	Reasoning	Score
Specificity	Lists six concrete actions — 'Generates, validates, reviews, queries, and compares structured research-paper sidecars, and fetches them from knows.academy' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what ('Generates, validates, reviews, queries, and compares... sidecars') and when ('Use for academic literature search, survey synthesis, paper authoring assistance, and peer review') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural phrases like 'academic literature search, survey synthesis, paper authoring assistance, and peer review' plus spec terms '.knows.yaml' and 'knows.academy' give good coverage, though common synonyms like 'find papers' or 'research papers' are absent.	4 / 5
Distinctiveness Conflict Risk	The Knows sidecar niche ('.knows.yaml', 'knows.academy', 'claim/evidence/relation access') is highly specific with distinct triggers and minimal overlap risk with general skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: first-fluke/oh-my-agent
Path: .agents/skills/oma-scholar/SKILL.md
Commit: 032c988

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.