Content
71%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 is an efficiently written abstraction catalog with a clear find-read-import workflow, but its actionability rests entirely on a source file that is not included in the bundle. Shipping the referenced source (or inlining the interface) would resolve the main weakness.
Suggestions
Include the referenced source file in the bundle (e.g. under references/) or inline the CliCommandFactory interface/types so the 'read the source file' step is actually executable.
Add one minimal copy-paste example of defining a command with CliCommandFactory so the common case is covered without reading the source.
Make the Source reference a resolvable relative path (e.g. [CliCommand.ts](references/CliCommand.ts)) instead of an opaque package path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient — three short usage steps plus a single catalog entry with no padding and no explanation of concepts Claude already knows, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | The import statement is copy-paste ready, but the central instruction 'You MUST read the source file to get the exact interface and types!' points to '@webiny/cli-core/abstractions/features/CliCommand.ts', which is not present in the bundle, leaving the key detail (the actual interface) unobtainable — concrete but incomplete guidance. | 3 / 5 |
Workflow Clarity | A clear, ordered three-step sequence (find abstraction → read source → import) appropriate for a simple catalog skill; the minor gap is the dangling source reference, and no validation checkpoints are needed since no destructive or batch operations are involved. | 4 / 5 |
Progressive Disclosure | Sections are well organized for such a short file, but the skill's only reference — the source file the whole workflow depends on — does not exist in the bundle, so navigation to the promised detail is broken rather than clearly signaled and resolvable. | 3 / 5 |
Total | 15 / 20 Passed |