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 skeleton: a padded, truncated persona intro followed by one-line pattern glosses and completely empty anti-pattern sections. It contains no actionable guidance — no schema example, no good-vs-bad description comparison, no error-response format — so an agent invoking this skill would learn the thesis (descriptions matter more than implementations) but not what to do.
Suggestions
Add concrete, executable content: a good vs. bad tool description pair, a minimal JSON Schema example with well-chosen descriptions, and a recoverable error-response format — these directly address the actionability score of 1.
Define a workflow for when the skill is invoked (e.g. 1. Review the tool's schema, 2. Rewrite descriptions using the pattern, 3. Define error responses, 4. Validate the schema) so Claude has a sequence to follow instead of only a persona.
Fill in or remove the empty Anti-Pattern sections, each with a one-line example of the failure and its fix, and trim the truncated persona intro to a single sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly terse, but the opening persona paragraph ('You are an expert in the interface between LLMs and the outside world... A simple tool with crystal-clear documentation will succeed') is motivational padding that adds no guidance, and it too is truncated ('You push for explicit error hand'). It does not fall to score 2 because only one section is padded and no space is spent explaining concepts Claude already knows. | 3 / 5 |
Actionability | There is no code, command, or example anywhere in the body — even the highest-value content, the pattern and anti-pattern sections, is purely nominal ('Returning errors that help the LLM recover', '❌ Vague Descriptions'). This matches the score 1 anchor: it only describes rather than instructs. | 1 / 5 |
Workflow Clarity | No steps or sequence of any kind are present; the body never tells Claude what to actually do when the skill is invoked (no design procedure, no review checklist, no validation of schemas). This matches the score 1 anchor of steps missing with no sequence; score 2 would require at least a rough sequence, which is absent. | 1 / 5 |
Progressive Disclosure | The body is short with clear section headers (Capabilities, Patterns, Anti-Patterns, Related Skills) and no nested references, but the three Anti-Pattern headers ('❌ Vague Descriptions', '❌ Silent Failures', '❌ Too Many Tools') are completely empty, and no bundle files exist to carry the example material this topic needs. It does not reach score 4 because empty sections and missing example content leave the organization incomplete rather than just minor-gapped. | 3 / 5 |
Total | 8 / 20 Passed |