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.
The body is a compact, well-structured command reference: executable CLI examples organized by workflow stage (before modify, after modify, audit, classify), with no verbosity or filler. Its only gaps are modest — no expected output shown for read/inspect and no explicit post-stamp verification — which keep actionability and workflow clarity at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every section earns its place: the two-sentence intro conveys what AKF is (a tool Claude would not know), commands are given as bare code blocks with no filler, and evidence examples are one-liners. This matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place' — there is no explanation of concepts Claude already knows and no padding to trim. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands cover the main cases: `akf stamp <file> --agent <agent-name> --evidence "..."`, `akf read <file>`, `akf inspect <file>`, `akf audit <file> --regulation eu_ai_act|hipaa|sox|nist_ai`, labels, and install. This fits 'Mostly executable guidance; concrete code or commands with minor gaps' — it falls short of 5 because expected output of read/inspect is not shown, so Claude cannot verify what a successful stamp or audit looks like. | 4 / 5 |
Workflow Clarity | Sections sequence the workflow by lifecycle stage — check existing metadata 'Before modifying existing files' (`akf read`/`akf inspect`), then stamp 'After creating or modifying files', then audit — which matches 'Clear sequence with most checkpoints present; minor validation gaps'. It is not 5 because there is no explicit verification step after stamping (e.g., re-reading the file to confirm the metadata was embedded), and not 3 because the pre-modification check does act as a checkpoint and each stage's commands are fully specified. | 4 / 5 |
Progressive Disclosure | The skill body is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist), and content is appropriately inline with clear, well-organized section headers. Per the rubric's simple-skill guideline ('For skills under 50 lines with no need for external references, progressive disclosure can score 5 with just well-organized sections'), this earns a 5 — nothing that belongs in a separate file is inlined, and navigation is trivial. | 5 / 5 |
Total | 18 / 20 Passed |