CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oma-academic-writing

Draft and revise academic prose against a rubric, evidence, and citation requirements. Use for essays, reports, literature reviews, or academic style audits.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

A well-sequenced orchestration skill with explicit validation checkpoints, feedback loops, and concrete craft rules inline. Its weaknesses are token redundancy (rules restated across Transitions, Failure/Recovery, Guardrails, and the Canonical workflow), craft details deferred to resource files that are not present in the bundle to verify, and prose-described rather than template-shown output formats.

Suggestions

Consolidate the repeated weaken-or-remove/quote-rubric/handoff rules into a single section (e.g., keep them in Guardrails only) and cut the restatements from Transitions, the Failure and recovery table, and the Canonical workflow path to reduce token cost without losing guidance.

Replace the prose descriptions of the draft/revise/review output formats with short inline block templates or one compact example per mode so the emitted format is copy-paste unambiguous.

Trim framework meta-structure (SSL primitive column, Resource scope/Memory tables) to the entries that change behavior, and ensure the referenced resources/ and ../_shared/core/ files ship with the skill bundle so the one-level-deep references are verifiable.

DimensionReasoningScore

Conciseness

The body is operational rather than educational (no explaining concepts Claude already knows), but the same rules are restated three to four times across Transitions, the Failure/Recovery table, Guardrails, and the Canonical workflow (e.g., weaken-or-remove unsupported claims appears in all four), and framework meta-tables (SSL primitives, Resource scope) add tokens without new guidance. This fits 'mostly efficient but could be tightened'; it does not reach 2 because there is little conceptual padding, nor 4 because the redundancy is substantial rather than minor.

3 / 5

Actionability

Concrete, executable instruction-craft guidance is present: exact thresholds ("em dashes ≤ 1 per paragraph; semicolons ≤ 2 per 1000 words"), banned terms ("definitely, clearly, obviously", "I think / I believe"), a specified 3-column Claim-Evidence Map, and per-mode output formats enumerated field-by-field. Not 5 because the craft substance (verb tiers, hedge calibration, sentence-type definitions) is entirely deferred to resource files not present in the bundle, and the mode output formats are described in prose rather than shown as templates; not 3 because process guidance within the body is specific and complete.

4 / 5

Workflow Clarity

A clearly sequenced pipeline (Entry steps, PREPARE→ACQUIRE→ACT→VERIFY→FINALIZE scenes, READ→PLAN→DRAFT→AUDIT→REVERSE-OUTLINE→POLISH path) with explicit validation (VERIFY scene, AUDIT step, "every fix loops back through the anti-AI checklist before emit"), feedback loops for error recovery ("If the same anti-AI flag survives one fix attempt → restructure the surrounding two sentences"), a failure/recovery table, and explicit exit criteria. This matches the top anchor; the writing task is not destructive/batch, so no cap applies.

5 / 5

Progressive Disclosure

Structure is good: a dedicated References section with load conditions ("load when drafting, revising, or reviewing an abstract"), dependencies listed, and one-level-deep references to resources/. Not 5 because no bundle files were provided to verify the referenced resources/ and ../_shared/core/ files exist, and the ~175-line body inlines considerable process scaffolding (full Scheduling and Logical Operations tables) that a leaner overview would trim or split; not 3 because references are clearly signaled and organized, not buried.

4 / 5

Total

16

/

20

Passed

Description

83%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 concise, third-person description that explicitly states both capability and trigger conditions with concrete natural phrases. It is close to the exemplar quality; the main gaps are missing common synonyms ("academic writing", "abstract", "thesis") and slightly broad terms like "reports" that invite minor overlap with generic writing skills.

DimensionReasoningScore

Specificity

"Draft and revise academic prose against a rubric, evidence, and citation requirements" plus "academic style audits" names three concrete actions in a clear domain, matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because related capabilities the body covers (polishing to rubric bands, rewriting AI-sounding prose, abstracts) are absent, and above 3 because more than 1-2 actions are named.

4 / 5

Completeness

The 'what' is explicit ("Draft and revise academic prose against a rubric, evidence, and citation requirements") and the 'when' is an explicit trigger clause with concrete phrases ("Use for essays, reports, literature reviews, or academic style audits"), matching the top anchor's structure. It is not 4 because the 'when' clause is already concrete and specific, not merely serviceable.

5 / 5

Trigger Term Quality

"Use for essays, reports, literature reviews, or academic style audits" provides four natural user phrases with good coverage. Not 5 because common synonyms are missing ("academic writing", "abstract", "thesis", "paper", "polish my draft"); not 3 because coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The rubric/evidence/citation framing carves a clear academic-prose niche with distinct triggers, but "reports" and generic editing overlap slightly with general writing/revision skills and sibling skills (oma-translation, oma-scholar). Fits 'mostly distinct; minor overlap risk with closely related skills'; not 5 because the broad terms leave non-trivial overlap with generic writing assistance.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

.claude-plugin/directory/skills/oma-academic-writing/SKILL.md

Reviewed

Table of Contents

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.