Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-structured instruction-only skill that conveys OKF semantics efficiently with concrete inline format examples and clear reading/maintenance sequencing. The only gaps are a missing complete worked frontmatter example and an explicit write-time validation checkpoint in the maintenance workflow.
Suggestions
Add one complete worked frontmatter example (type, sources with id, generated/verified, stale_after) so authors can copy the exact shape rather than reassembling it from scattered rules.
In 'Read and maintain a bundle', insert an explicit validation checkpoint — after writing a concept, run the `okf` plugin audit / consult `.ok/okf/*.schema.json` before adding the log entry — to close the validate→fix loop for durable writes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, dense set of bullet rules that assumes Claude knows Markdown/YAML/links and adds only OKF-specific semantics; nearly every token (e.g. the reserved-file rules, the ISO-timestamp constraint) earns its place. | 5 / 5 |
Actionability | Concrete format examples are inline ('## YYYY-MM-DD: Summary', 'stale_after: 2026-12-31T00:00:00Z', 'human:'/'process:' prefixes), but there is no single complete worked frontmatter example for authors to copy, leaving a minor gap. | 4 / 5 |
Workflow Clarity | 'Read and maintain a bundle' gives a clear sequence (nearest index.md → inspect frontmatter → follow relevant links → write discoveries back → add log entry) with judgment checkpoints ('trust the bundle; if missing or inconsistent, say so'), but an explicit post-write conformance validation step is only implied via the plugin section. | 4 / 5 |
Progressive Disclosure | Under ~50 lines with no external references needed and no bundle files, the content is cleanly split into four well-signaled sections (Core rules, Authoring judgment, Read and maintain, okf plugin), meeting the simple-skill exception for a top score. | 5 / 5 |
Total | 18 / 20 Passed |