Content
96%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 headless-skill body: terse rules, a fully specified input and output contract, concrete quality examples, and explicit edge-case handling. The only structural nit is that the long inline output schema pushes the file past the size where splitting content out would be ideal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — "Read only the input file named in the prompt. Read nothing else and run no commands." No concept Claude already knows is explained; the inline JSON schema block is the one large element and it earns its place as the exact output contract. Nothing reads as padding. | 5 / 5 |
Actionability | Fully executable guidance: exact input field definitions ("`day` (string, YYYY-MM-DD) and `hour` (integer, 0-23)"), precise timeline constraints ("must lie within the hour (an `end` of the next hour's `:00` is allowed)"), a concrete good/bad example ("'Edited Capture.swift to recheck exclusions before screenshots', not 'Worked on code'"), and a literal empty-input return object. An LLM can execute this without guessing. | 5 / 5 |
Workflow Clarity | A simple single-purpose skill whose single action is unambiguous: read the one input file — with an explicit completion condition ("read it in parts (offset/limit) until you have read all of it") — then emit one JSON object matching the schema. There are no destructive or batch operations, so no validation checkpoint is required, and the empty-input case is explicitly handled. | 5 / 5 |
Progressive Disclosure | Well-organized sections (Rules, Input, task-specific rules, Output schema) with no buried or nested references and no bundle files to navigate. It falls short of the 5 anchor because the ~75-line inline JSON schema makes the body ~111 lines, exceeding the simple-skill threshold where inline-everything is ideal placement; the schema could arguably live in a reference file, though keeping the always-needed output contract inline is defensible. | 4 / 5 |
Total | 19 / 20 Passed |