Content
92%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.
An exemplary operational skill body: exact commands, file names, and formats; a prioritized decision procedure with a refusal-and-recovery path for every failure mode; and disciplined, tutorial-free prose. The only flaw is minor — two duplicated statements about late-arriving facts and un-saved batches that could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no concept explanations, no padding — but two facts are stated twice: invariant 9's "facts that arrive while you work wait for the next promotion" duplicates the Environment-facts bullet "facts proposed since then wait for the next promotion", and situation 3's "Saving nothing hands the same batch to every later run" duplicates the closing bullet "If you do not save, the facts stay waiting and a later promotion run gets them again". These minor redundancies could be trimmed, fitting anchor 4 rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Fully concrete, executable guidance: exact command syntax ("tessl memory pending --topic <topic> --out-dir <dir>", "tessl memory save --topic <topic> --file <note file> --note-version <version>", "--allow-empty"), exact file names ("note.md", "facts.json", ".cloud-launch/inputs.json"), a precise line format ("- <fact> (<who>, <YYYY-MM-DD>)"), quoted failure text ("Could not write the promotion input"), and how to source the topic. Per the rubric's scoring note, an instruction-only skill with guidance this specific and executable earns the top anchor. | 5 / 5 |
Workflow Clarity | The workflow is a first-match decision list ("Take the first situation that applies", four ordered situations) plus explicit validation and recovery loops for every failure mode of this destructive batch operation: version-mismatch refusal → re-run pending and rewrite; over-48 KB refusal → trim per invariant 8 and re-save; folder refusal → new folder, second refusal → stop and report; no-answer save → retry, whose refusal then confirms success. The batch-operation cap at 3 does not apply because validation checkpoints and feedback loops are present throughout. | 5 / 5 |
Progressive Disclosure | There are no bundle files, and none are needed: the skill is single-purpose and every section (situations, invariants, CLI behaviors, judgment rules) is load-bearing each time it runs, so splitting content out would only add a mandatory file read. The body is well-sectioned with a clear hierarchy (What done looks like → Invariants → Environment facts → Judgment), making navigation trivial — the spirit of the self-contained well-organized-skill allowance. | 5 / 5 |
Total | 19 / 20 Passed |