CtrlK
BlogDocsLog inGet started
Tessl Logo

wagneripjr/okf-maintain

Adopt and maintain an Open Knowledge Format v0.2 documentation bundle: frontmatter, generated indexes, a fail-closed conformance check, and coverage that names every unindexed document

72

Quality

91%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

The skill body is highly actionable, with clear validated workflows and clean one-level-deep reference structure. Its main weakness is length: several sections argue the rationale at length where tighter phrasing would preserve clarity.

Suggestions

Tighten the 'A declared profile is reported, not obeyed' and Coverage sections: convert the multi-sentence rationales into one-sentence rules, moving extended justification to a reference file.

Trim rhetorical restatements of the same hazard (e.g. the 'clean bill issued over zero files' phrasing appears twice near-verbatim) to a single statement.

Consider moving the long-form hook refusal list and coverage edge-case explanations into references/ so the SKILL.md body stays a quick-start overview.

DimensionReasoningScore

Conciseness

The body is mostly efficient and purposeful, but the profile-declaration and coverage sections repeat hazards and argue persuasively ('a guard whose condition nothing can satisfy is a defect wearing a guard's clothes') beyond what Claude needs to execute, so it could be tightened.

3 / 5

Actionability

Fully executable copy-paste commands with real paths and flags (e.g. 'okf.mjs index docs --describe requirements=...'), concrete frontmatter examples, and named exit codes tied to actions cover the common cases.

5 / 5

Workflow Clarity

Two sequenced workflows include explicit validation checkpoints (triage before write; 'check' and 'coverage' must exit 0) and feedback loops ('77' is never a pass), and destructive steps like 'git rm log.md' are guarded by validation.

5 / 5

Progressive Disclosure

The body is an overview that signals three real one-level-deep references (frontmatter.md, index-format.md, adoption.md) and a bundled script, with no nested references and content appropriately split.

5 / 5

Total

18

/

20

Passed

Description

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

The description is dense, specific, and explicit about both capabilities and triggers, with clear negative-scope boundaries that prevent conflicts. It is exemplary except for one mildly abstract verb ('bootstraps a conformant tree').

DimensionReasoningScore

Specificity

Lists many concrete actions with named files and mechanisms ('stamps and repairs YAML frontmatter', 'regenerates every index.md bottom-up', 'wires CLAUDE.md/AGENTS.md/GEMINI.md'), but 'bootstraps a conformant tree' is somewhat abstract, so it sits just below the fully comprehensive anchor.

4 / 5

Completeness

It explicitly answers both what the skill does and when to use it, with concrete trigger phrases and negative scope ('NOT for writing a document's body'), matching the top anchor.

5 / 5

Trigger Term Quality

An explicit 'Triggers on:' clause plus a 'Use when' opening supplies six natural user phrases ('set up OKF', 'regenerate the docs index', 'which docs are missing from the index'), giving comprehensive coverage of natural terms.

5 / 5

Distinctiveness Conflict Risk

Niche is sharply defined by OKF-specific files (.okfignore, index.md, log.md) and explicit boundary clauses against the adr skill and content authoring, minimizing misfire risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents