CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oma-skill-creation

Create or revise OMA skills and their references. Use for skill routing, execution contracts, conditional loading, and authoring validation.

Quality

85%

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

88%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 dense, well-governed authoring procedure: lean prose, a sequenced workflow with explicit validation commands and failure-recovery loops, and conditionally-loaded references with stated load conditions. The main gaps are directional guidance where tools or documents are referenced but not verifiable in the bundle, and reference paths with inconsistent bases.

DimensionReasoningScore

Conciseness

The 78-line body is telegraphic and assumes Claude's competence ('Installing third-party skills -> skill installer', 'Keep SKILL.md under 500 body lines') with zero padding or explanation of concepts Claude already knows. Every line carries a rule, transition, or command, matching the 'lean and efficient' anchor rather than anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

The canonical path supplies copy-paste-ready commands ('oma skill lint --skill <name>', 'git diff --check') and concrete paths ('.agents/skills/{name}/SKILL.md'), but some guidance stays directional — 'Use the documented fallback' without naming it, and the template/checklist artifacts live in resources absent from the bundle. Mostly executable with minor gaps, so anchor 4 rather than the fully-executable anchor 5; clearly above anchor 3, where guidance would be pseudocode-level.

4 / 5

Workflow Clarity

The six-step Canonical workflow path is explicitly sequenced with a dedicated validation step (lint, git diff --check, audit, plus the validation checklist), a five-row Failure and recovery table providing feedback loops, and a final reporting step that surfaces unresolved limits ('Do not claim reduced token usage merely from removing duplicate files; measure'). This matches anchor 5's explicit checkpoints, error recovery, and checklists; anchor 4 would lack some of these.

5 / 5

Progressive Disclosure

The References section signals each resource with a load condition ('resources/ssl-lite-template.md (authoring or restructuring)') and keeps detail one level deep, but none of the six referenced files exist in the provided bundle and path bases are inconsistent ('resources/', '../_shared/core/', 'web/docs/guide/'). Good structure with minor organization gaps puts this at anchor 4 rather than the fully verifiable, easy-navigation anchor 5; it is well above anchor 3's inline-bloat problem.

4 / 5

Total

18

/

20

Passed

Description

75%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 well-structured description with a clear 'what', an explicit 'Use for' clause, and domain-specific trigger terms, all consistently above the midpoint. It is not exemplary: the when-clause uses task-category phrasing rather than natural user-voice triggers, keyword variations like 'SKILL.md' are missing, and disambiguation from neighboring skill-management skills is left entirely to the body.

Suggestions

Rewrite the 'Use for' clause with concrete user-voice triggers, e.g., 'Use when creating, editing, or auditing a SKILL.md, fixing skill routing, or deciding where reference content lives.'

Add natural keyword variations users would actually say — 'SKILL.md', 'edit/update a skill', 'audit a skill' — to strengthen trigger matching.

Add a brief carve-out in the description (e.g., 'Not for installing third-party skills') to reduce conflict risk with neighboring skill-management skills.

DimensionReasoningScore

Specificity

Names concrete actions ('Create or revise OMA skills and their references') plus four capability areas ('skill routing, execution contracts, conditional loading, and authoring validation'), which is several specific items with minor gaps. It sits above anchor 3's '1-2 concrete actions' but below anchor 5, since the 'Use for' areas read as topical categories rather than fully concrete actions.

4 / 5

Completeness

The 'what' is clear ('Create or revise OMA skills and their references') and an explicit 'Use for...' clause provides when-guidance, so it clears the anchor-3 cap for missing triggers. The when-clause names task categories rather than concrete user-voice trigger phrases (e.g., 'when the user mentions SKILL.md or skill routing'), matching anchor 4's 'when could be more explicit or specific' rather than anchor 5.

4 / 5

Trigger Term Quality

'Create', 'revise', 'skill routing', and 'authoring validation' are natural terms for this skill's audience, giving good keyword coverage. Common variations and file-level triggers a user would actually say — 'SKILL.md', 'edit', 'update', 'audit' — are absent, keeping it below anchor 5's comprehensive synonym/extension coverage; it is clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

'OMA skills and their references' carves a clear niche that would not trigger for unrelated work, but the description does not disambiguate against closely related skill-management skills (the body mentions a skill installer and plugin tooling as separate routes). Minor overlap risk with closely related skills places it at anchor 4 rather than the minimal-conflict anchor 5, and well above the generic anchors 1-2.

4 / 5

Total

16

/

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

.agents/skills/oma-skill-creation/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.