Content
85%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 diagnostic skill: it captures the non-obvious root cause, the exact framework fields to use instead, and a testing recipe that reproduces the real-Terraform-only bug. The only gaps are a small time-sensitive version pin and the absence of a short code snippet for matching the configured item via req.Path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token earns its place — root cause (items sorted separately, paired by index), exact fix fields (req.PlanValue, AtSetValue step of req.Path), and a source-file pointer. The pinned 'v1.17' version number is time-sensitive detail not placed in an old-patterns/deprecated section, keeping it just below the lean anchor-5 exemplar. | 4 / 5 |
Actionability | Concrete, specific guidance throughout: 'use req.PlanValue as the prior value', 'the AtSetValue step of req.Path holds it', pointers to fwserver/attribute_plan_modification.go and setItemConfig, plus a resource.UnitTest recipe with two items. It stops short of fully executable copy-paste code for the item-matching step, which the reader must still implement. | 4 / 5 |
Workflow Clarity | A simple single-purpose skill with an unambiguous Trigger → Fix (two sequenced bullets) → Why/verify structure; the 'Cover it with resource.UnitTest and two items' line is an explicit validation checkpoint for the fix, so the simple-skill exception applies fully. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no bundle files needed; sections are well-organized (Trigger / Fix / Why) and the single external reference ('see setItemConfig in tools/iac-codegen/.../schema.go.tmpl') is clearly signaled and one level deep. | 5 / 5 |
Total | 18 / 20 Passed |