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 reads as a product landing page rather than operational instructions: it enumerates capabilities and includes one illustrative calculation, but provides none of the formulas, templates, or step-by-step procedures needed to actually execute the skill's tasks. It would leave Claude unable to perform the advertised work without guessing.
Suggestions
Replace the marketing overview and FAQ with the actual indexation procedure: the health-index formula, the region-specific EPC/EPB correction-factor tables, and a worked calculation with the intermediate steps shown.
Add step-by-step workflows for the core tasks (draft a contract, compute indexation, generate a notice letter), including where to look up Statbel indices and a final human-review checkpoint per the stated limitation.
Move contract skeletons, letter templates, and plaatsbeschrijving checklists into referenced files (e.g. references/contracts.md, references/templates.md) and link them from a lean overview section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded with marketing prose ('Unlike generic AI prompts, this skill integrates...', 'significantly reducing the risk of legal disputes or administrative fines') and a six-question FAQ that largely restates the description, plus trailing promotional links — several sections that earn no operational value. | 2 / 5 |
Actionability | The only concrete material is a worked example (Base Rent €850, EPC Correction Factor 0.95, New Rent €885.25), but no indexation formula, correction-factor table, contract skeleton, or letter template is provided; the body even states 'Scripts, extension source, and templates from the original package are not in this folder', leaving only high-level hints. | 2 / 5 |
Workflow Clarity | No sequenced steps exist for any core task — contract drafting, indexation calculation, or notice-letter generation — and the sole validation note ('Legal output requires final human review') has no accompanying validate/fix loop. | 1 / 5 |
Progressive Disclosure | Sections are labeled ('What you can generate', 'When to use', 'Known limitations') and no bundle files exist, but the FAQ/marketing copy is inlined while the content that clearly belongs in reference files (correction-factor tables, contract templates, letter formats) is absent rather than linked. | 3 / 5 |
Total | 8 / 20 Passed |