Content
88%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: hard anti-hallucination rules, a verified consumption matrix, exact commands and templates, and a mandatory verification-report format with escalation to the user. Its only real weakness is mild repetition of the hard rules across sections and an all-inline structure that forgoes any progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with repo-specific facts Claude could not know (Consumption Matrix, hosted-billing rules, per-provider doc URLs) and wastes no tokens explaining known concepts, but there is deliberate redundancy — the Hard rules are restated across Steps 2, 4, and 6 ('Always re-grep before relying on this table', 'Cite every fact', 'never delete it to make lint pass') — a level of anchor-5 leanness it does not quite reach. | 4 / 5 |
Actionability | Every instruction is copy-paste executable: exact WebFetch prompts, exact 'rg "reasoningEffort|reasoning_effort" apps/sim/providers/<provider>/' grep commands, a full TypeScript entry template with field-order and inline comments, exact 'bun run lint' / 'bun run agent-stream-docs:generate' commands, and a mandatory verification-report table format. Nothing is pseudocode or hand-waved. | 5 / 5 |
Workflow Clarity | A clear 6-step sequence with explicit validation checkpoints and feedback loops: 'Lint must pass before you report done — fix the entry you wrote, never delete it to make lint pass', 'If you cannot reach an authoritative source for any field, mark the field as UNVERIFIED... ask the user before guessing', the hosted-billing assertion 'verify with getHostedModels().includes(...)', and the CI-diff check on regenerated docs. Error-recovery paths (source not found, lint failure, test breakage) are each explicitly handled. | 5 / 5 |
Progressive Disclosure | Well-sectioned single-file skill with clear headings, tables, and step navigation, and no bundle files to mis-link. It sits at anchor 4 rather than 5 because ~190 lines are all inline with zero references — conditional sections like 'Reseller providers', 'Wrong family entirely?', and the full Consumption Matrix/URL table load on every invocation when they could live one level deep in reference files. | 4 / 5 |
Total | 18 / 20 Passed |