Content
90%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 scaffolding skill: fully executable code per artifact, terse project-specific conventions, and a verified build/test step with a checklist. The only gaps are a missing error-recovery loop in the workflow and two references that lack paths or links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every sentence carries project-specific, non-inferable facts ('There is no generic IRepository<T>. Inject the module's {X}DbContext', 'TreatWarningsAsErrors', 'Architecture.Tests fails the build if a command... has no validator'). It explains nothing Claude already knows, matching the anchor-5 profile of every token earning its place. | 5 / 5 |
Actionability | Every step ships complete, executable C# (command record, handler with guard clause and SaveChangesAsync, validator with rules, endpoint with permission/idempotency wiring) plus exact shell commands ('dotnet build src/FSH.Starter.slnx', 'dotnet test src/Tests/{X}.Tests'). The {Entity}-style placeholders are the skill's argument interface rather than pseudocode, and the single ellipsis in Step 5 legitimately denotes pre-existing user code. | 5 / 5 |
Workflow Clarity | Steps 1-6 are clearly numbered with an explicit verification step (build with 0 warnings, add a test) and a closing checklist, which goes beyond anchor 3's implicit checkpoints. It falls short of anchor 5 because there is no error-recovery feedback loop — e.g., what to do when Architecture.Tests fails the build or when warnings appear — leaving that recovery implicit. | 4 / 5 |
Progressive Disclosure | The file is well-sectioned, self-contained for the core workflow, and defers bulk conventions to one-level-deep references signaled up front ('Full conventions: .agents/rules/api-conventions.md'). It sits below anchor 5 because two inline references ('see query-patterns', 'see testing-guide') are given as bare names without paths or links, making navigation to them slightly ambiguous. | 4 / 5 |
Total | 18 / 20 Passed |