Content
22%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 single self-describing sentence that documents its own deficiencies rather than providing any executable guidance or workflow. It earns a middling conciseness score only because it is short, while failing entirely on actionability and workflow clarity.
Suggestions
Replace the descriptive sentence with concrete, executable instructions (code blocks or specific commands) for the skill's task.
Add a numbered, sequenced workflow with validation checkpoints if the task involves batch or destructive operations.
State the single concrete action the skill performs so a simple skill can satisfy actionability unambiguously.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is only one sentence and not padded with concepts Claude already knows, so it is lean; however it is terse to the point of conveying no useful instruction, which slightly offsets the token-efficiency benefit. | 3 / 5 |
Actionability | The body 'This skill body lacks ordered steps, imperative verbs, code examples, and guardrails.' only describes what is missing; it provides no concrete code, commands, or executable guidance, matching the entirely-vague anchor. | 1 / 5 |
Workflow Clarity | No steps or sequence are present, and for any risky operation there is no validation; the content explicitly states it lacks ordered steps, matching the missing/incoherent anchor. | 1 / 5 |
Progressive Disclosure | The body has a single section header and no bundle files to reference; for an under-50-line skill with no external references needed, the minimal organization is acceptable, though it signals nothing useful for navigation. | 3 / 5 |
Total | 8 / 20 Passed |