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 reference skill: dense, project-specific, and immediately actionable, with the highest-value information (the MediatR trap, the two-host registration requirement) surfaced prominently. The only improvement space is an explicit post-registration verification step, which keeps workflow clarity at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense — two tables, one code block, and a rules paragraph with zero conceptual padding or explanations of things Claude already knows. The repeated Mediator-not-MediatR warning at the top is the one deliberate emphasis of the skill's #1 failure mode, and it earns its tokens; every other line is novel, project-specific information. | 5 / 5 |
Actionability | Fully concrete guidance: exact interface names in a use/don't-use table, a copy-ready command+handler pattern with the real project folder paths, exact registration code for both Program.cs hosts, and a symptom→cause→fix error table. The {X}/{Entity} placeholders are template parameters of the module procedure rather than pseudocode, and the specific examples cover the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The registration section lays out a clear, countable procedure ("two markers", "in both FSH.Starter.Api/Program.cs and FSH.Starter.DbMigrator/Program.cs") and the Common errors table provides symptom→fix recovery, but there is no explicit validation checkpoint (e.g. verify the handler resolves/compiles after registration) — clear sequence with a minor checkpoint gap, matching 4 rather than 5. | 4 / 5 |
Progressive Disclosure | At ~60 lines the body is a well-organized single-level overview: everything needed at a glance (interfaces, pattern, registration, errors) lives inline, and the deeper multi-step procedure is cleanly delegated one level out via "See `add-module` for the full procedure." No nested references, no inlined content that belongs elsewhere; navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |