Content
93%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 lean instruction skill: it gives exact MCP tool names and fallback HTTP routes, a crisp 4-step pre-write lookup workflow, and hard guardrails ('Never guess type names') without a wasted token. The single minor gap is the absence of an explicit post-write validation checkpoint to confirm written config matches the fetched schema.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence adds operational information Claude would not know — the MCP server name, its setup command, 'never run `lowdefy dev` yourself or choose a port', the `directory` parameter, the HTTP fallback routes, and exact tool names. There is no padding or explanation of known concepts, matching the 5 anchor ('every token earns its place'). | 5 / 5 |
Actionability | The body names concrete, directly callable tools (`lowdefy_list_types`, `lowdefy_get_schema`, `lowdefy_get_examples`, `lowdefy_get_doc`, `lowdefy_search_docs`) and exact HTTP routes (`GET /lowdefy-docs/blocks`, `/lowdefy-docs/schema/{kind}/{type}`, `/lowdefy-docs/examples/{type}`). Per the rubric's scoring notes, an instruction-only skill without code is not penalized when the guidance is this executable; it matches the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear numbered lookup sequence (list types → get schema → get examples → get doc/search) with unambiguous, named steps. It sits above the 3 anchor (sequence present, checkpoints implicit — here 'Never guess type names' acts as an explicit guardrail) but below the 5 anchor, which expects an explicit validation checkpoint such as verifying written config against the fetched schema before finishing. The operation is read-only lookup, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no bundle files (no references/, scripts/, or assets/ exist), and all detailed documentation is sourced at runtime from the MCP tools rather than inlined. Per the rubric guideline, skills under 50 lines with no need for external references can score 5 with well-organized sections, which this numbered-list structure provides. | 5 / 5 |
Total | 19 / 20 Passed |