CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-docs

Verify documentation references against the current codebase, propose updates for diff-affected docs, detect i18n translation drift, and lint translated docs for CJK style issues. Use to check if docs still match reality (broken file paths, CLI commands, config keys, env vars, scripts), to surface docs that may need updating after code changes, or to find stale or style-broken translations.

77

Quality

96%

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

92%

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

The content is highly actionable and workflow-clear: executable commands, explicit validation checkpoints, and a thorough failure/recovery model. Its weakness is progressive disclosure — the body is dense and largely monolithic with only a single one-level reference, where more material could be offloaded to the design doc.

Suggestions

Move the per-file dependency list, actions table, and resource-scope table into the design doc (008-oma-docs.md), keeping SKILL.md as a concise overview with signaled pointers.

Replace the repeated inline 'No LLM call' caveats across six file entries with a single consolidated host-LLM contract note to reduce repetition.

Add explicit bundle reference files (e.g. a REFERENCES.md for the CLI flag matrix) so detail lives one level deep rather than inline in SKILL.md.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence and avoids explaining concepts Claude already knows; every section delivers concrete CLI behavior or guardrails rather than padding. The only mild redundancy is the repeated 'No LLM call' caveat, which is minor and earns its place by clarifying the host-LLM contract.

3 / 3

Actionability

Provides copy-paste-ready, executable commands with exact flags and comments (e.g. 'oma docs verify --json', '--report-file ./drift-report.md', '--no-urls', 'oma docs sync HEAD~5..HEAD'), plus concrete interactive prompts and git apply steps.

3 / 3

Workflow Clarity

Clear Entry → Scenes → Transitions → Failure-and-recovery → Exit sequence with an explicit VERIFY checkpoint (JSON schema / candidate-list validation) and a dedicated failure-and-recovery section covering parse errors, missing lychee, context limits, and write failures.

3 / 3

Progressive Disclosure

The single reference (design doc 008-oma-docs.md) is one level deep and clearly signaled in the References section, but no bundle files exist and the ~280-line body inlines substantial detail (full dependency list, actions table, resource scope) that could be split out, leaning monolithic.

2 / 3

Total

11

/

12

Passed

Description

100%

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

The description is specific, trigger-rich, complete, and distinct: it names four concrete operations, gives explicit 'Use to...' triggers covering natural phrasings, and carves out a niche by deferring overlapping work to sibling skills. It is written in third person and avoids fluff.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — verify references against the codebase, propose updates for diff-affected docs, detect i18n translation drift, and lint translated docs for CJK style — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly states what the skill does (the four operations) and when to use it ('Use to check if... to surface... or to find...'), satisfying both the what and the when with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural terms a user would say — 'docs still match reality', 'broken file paths, CLI commands, config keys, env vars, scripts', 'stale or style-broken translations' — giving good coverage of common phrasings.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (documentation drift detection) and explicitly defers adjacent work (translation/restructuring to oma-translator, semantic drift to v2), making conflict with other skills unlikely.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
first-fluke/oh-my-agent
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.