Content
100%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.
The body is a well-engineered overview: dense one-line principles, executable commands with flags, an explicitly sequenced 12-phase workflow with confirm/lint validation checkpoints, and clean delegation to real, one-level-deep reference and asset files. No padding, no inferred-only steps, and no monolithic content that belongs in bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~75-line body is lean and assumes Claude's competence: one-line numbered principles ('Interview before building', 'Lean questions. At most 3 to 5 per block'), a compact three-command code block, and summary rules that delegate full detail to references. It never explains concepts Claude already knows, and every token carries guidance, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Guidance is copy-paste ready: 'python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech', the linter and index-generator invocations, a concrete recommended flow ('scaffold → interview per phase → write concepts → okf_linter → index_generator'), and a numbered startup procedure with exact first actions including 'Stop and wait' for answers. This covers the common cases an executing agent needs. | 5 / 5 |
Workflow Clarity | The multi-step process is explicitly sequenced — the 12-phase chain with conditional skips ('06-produto (skip if pure service)', '08-tech (only if there is digital infrastructure)'), per-phase steps (a)-(e) — and includes real validation checkpoints: 'Confirm before generating... ask for ok' plus running okf_linter after each phase, forming a validate-fix-retry loop for the batch file generation. This matches the anchor with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | SKILL.md is a true overview with well-signaled, one-level-deep references: conformance rules summarized with 'full detail in references/okf_conformance.md', phase details in phase_playbook.md, the type vocabulary in type_vocabulary.md, and templates under assets/ — every referenced path verified to exist in the bundle. Content is appropriately split and navigation is easy, matching the top anchor. | 5 / 5 |
Total | 20 / 20 Passed |