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.

66

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, highly structured process skill with explicit validation loops and concrete quantitative style rules, undermined by systematic restatement of the same rules across overlapping sections and by referenced resource files that are not included in the bundle.

Suggestions

Consolidate duplicated rules: state each rule (claim-evidence handling, verb selection, hedging calibration, mode branching) once — in Guardrails or the canonical workflow — and remove the repetitions across Scheduling, Scenes, Transitions, and the failure table.

Include the referenced `resources/` files (anti-ai-checklist, sentence-structure-reference, academic-verb-tiers, hedging-guide) in the bundle, or inline their essential tables so the signposted navigation actually resolves.

Add one compact worked example per mode (a short original→revised block for `revise`, and a filled Claim-Evidence Map row) so the named output formats are concrete rather than described.

DimensionReasoningScore

Conciseness

The body is mostly operational guidance rather than concept explanation, but the same rules are restated across many sections: 'weaken or remove' unsupported claims appears in Transitions, the failure table, Guardrail 9, and Canonical workflow step 5; verb-selection guidance repeats in Entry, Scene ACT, the failure table, and Guardrail 4. This systematic duplication across Scheduling/Scenes/Actions/Canonical-workflow is padding that could be consolidated — anchor 3 ('could be tightened'), not 5; not 2 because none of it explains things Claude already knows.

3 / 5

Actionability

For an instruction-only skill the guidance is largely concrete: named modes with defined output formats, quantified style rules ('Em dashes ≤ 1 per paragraph; semicolons ≤ 2 per 1000 words'), a 3-column Claim-Evidence Map, and a Topic-Support-Conclude template. Minor gaps: the mode output formats are named but never exemplified, and no sample before/after revision is shown, which keeps it below 'fully executable' anchor 5.

4 / 5

Workflow Clarity

The sequence is explicit — Entry → PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE → Exit — with validation checkpoints (VERIFY audit, read-aloud test, PASS/FAIL compliance report), a failure/recovery table, and genuine feedback loops ('If the same anti-AI flag survives one fix attempt → restructure the surrounding two sentences'; 'every fix loops back through the anti-AI checklist'). This matches the anchor-5 pattern of clear sequencing, explicit validation, and error-recovery loops, exceeding anchor 4's 'minor validation gaps'.

5 / 5

Progressive Disclosure

Structure is good: detailed protocols are pushed to clearly signaled one-level-deep references (`resources/anti-ai-checklist.md`, `sentence-structure-reference.md`, `academic-verb-tiers.md`, `hedging-guide.md`, plus shared core files), each with a stated purpose in Dependencies and a References section. It does not reach 5 because the referenced `resources/` and `../_shared/core/` files are not present in this bundle (only SKILL.md ships), so the signposted navigation cannot be verified or followed.

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 tight, third-person description that clearly states both capability and trigger conditions with concrete natural-language terms. Minor gains available from broader trigger synonyms and a fuller action inventory.

Suggestions

Add common trigger synonyms such as 'paper', 'thesis', 'dissertation section', or 'polish this draft' to the 'Use for' clause to widen natural-keyword coverage.

Mention one or two more distinctive capabilities (e.g., claim-evidence verification or anti-AI-style audits as an explicit verb) to sharpen the action inventory beyond draft/revise/audit.

Clarify that it covers academic writing only (not business/marketing copy) to reduce the residual overlap with generic report-writing skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Draft and revise academic prose' plus 'academic style audits' — grounded in a named constraint set ('against a rubric, evidence, and citation requirements'). It is not a comprehensive action inventory (no mention of claim-evidence mapping or reverse outlining), which keeps it below 5 and above the 1-2-action anchor at 3.

4 / 5

Completeness

Both questions are explicitly answered: what — 'Draft and revise academic prose against a rubric, evidence, and citation requirements'; when — 'Use for essays, reports, literature reviews, or academic style audits' with concrete trigger phrases. This matches the anchor-5 example pattern ('Extract... Use when...') and exceeds anchor 4, whose 'when' clause is generic.

5 / 5

Trigger Term Quality

Natural user phrases are present: 'essays, reports, literature reviews, or academic style audits' — terms a user would plausibly say. Common variations like 'paper', 'thesis', 'polish my draft', or 'make this sound less AI' are missing, so coverage is good but not comprehensive (anchor 4, not 5).

4 / 5

Distinctiveness Conflict Risk

'Academic prose' bound to rubric/evidence/citation requirements carves a clear niche distinct from generic writing or document skills. Minor overlap risk remains with adjacent academic skills (e.g., citation gathering or translation) and with business-report writing, so it sits at 'mostly distinct' rather than 'minimal conflict risk'.

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

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.