Content
72%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.
A highly actionable, token-efficient CLI reference whose commands are executable as written. Its two structural weaknesses are the absence of validation guidance around destructive/batch operations and the monolithic single-file layout, where the deep promotions material would be better split into a referenced file.
Suggestions
Add verify-first steps before destructive and batch commands, e.g. "run `n8n-cli workflow get <id>` to confirm the right workflow before `workflow delete`", and note how to verify row changes after `data-table add-rows`/`upsert-rows`.
Move the detailed Promotions walkthrough (connection JSON, apply/apply-continue exit-code handling, key points) into a reference file (e.g. references/promotions.md) and keep a short overview with a clearly signaled link in SKILL.md.
Trim the "Composability Patterns" section, since --jq/--json/--no-header usage is already demonstrated inline in the command sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely terse, executable command blocks with no re-teaching of concepts Claude already knows. The "Composability Patterns" section re-illustrates --jq/--json usage already shown inline, which is minor trimmable redundancy. | 4 / 5 |
Actionability | Every command group comes with copy-paste-ready invocations covering flags, stdin/file input variants, and concrete JSON payloads (connection config, workflow structure), so the common cases are fully executable. | 5 / 5 |
Workflow Clarity | The promotions flow is well sequenced with a genuine feedback loop ("Exit 3: the source changed since the review. Review again"; "Exit 4: ... Resolve them, then run the apply-continue command"), but destructive and batch commands (workflow delete, credential delete, data-table delete-rows --ids=...) carry no verify-first guidance, and the rubric caps this dimension at 3 for missing validation on destructive/batch operations. | 3 / 5 |
Progressive Disclosure | Sections are clearly organized per command group, but this is a ~375-line inline CLI reference with no bundle files; the promotions detail in particular is exactly the content that belongs in a separate one-level-deep reference file. | 3 / 5 |
Total | 15 / 20 Passed |