Content
88%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 excellent operational skill body: every section carries n8n-specific semantics Claude could not infer, guidance is executable down to tool arguments and result fields, and validation/safety checkpoints are unusually thorough for operations that can touch real user data. The only refinements available are consolidating the repeated write-safety emphasis and splitting the tool-running deep-dive into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (it never explains what n8n, a 401, or a credential is) and is dense with tool-specific semantics Claude cannot know ("workflowVersionId vs activeVersionId", "unreconstructable-context", "ranThroughNodeNames"). The write-safety rule is restated in several places ("Running one sends the message, charges the card, or deletes the row", "Mocked input does not make a write node safe", "The approval prompt alone is not consent"), which is deliberate emphasis but could be consolidated — efficient with minor trims, matching anchor 4 rather than anchor 3's genuinely unnecessary asides. | 4 / 5 |
Actionability | Fully executable guidance with concrete invocations ("run_workflow_step(workflowId, nodeName, reuseExecutionId=<the failed execution>)", a complete toolArguments example, "get_resolved_node_parameters(executionId, nodeName)"), specific result fields ("failedExpressions", "emptyResolutions", "inputMode: 'mocked'"), and concrete decision rules (GET vs non-GET, safe-verb lists). The examples cover the common cases: auth errors, failed runs, wrong-output runs, tools, and sub-nodes. | 5 / 5 |
Workflow Clarity | Explicit validation checkpoints and feedback loops run throughout: "Re-run the failing path ... and inspect the real result before responding", "Say what you checked before you say why it failed", the version check ("Only a row whose workflowVersionId equals workflow.activeVersionId ran the published code"), and "a new live run is what confirms the fix". The destructive-operation cap does not apply because the skill includes a full safety checklist ("Safe to run / Do not run for real / Unsure? Treat it as a write") and refused-replay recovery guidance; scenario-based rather than numbered organization suits a debugging skill. | 5 / 5 |
Progressive Disclosure | Well-organized sections, core judgment rules correctly kept inline, and one clearly signaled external pointer ("read the workspace file knowledge-base/reference/trigger-input-data-shapes.md when a sandbox workspace is available"). It stops short of anchor 5 because the ~60-line "Running a tool" subsection is a specialized deep-dive that could live in a reference file and the ~243-line body is an operational manual rather than an overview — good structure with minor organization gaps, clearly above anchor 3's inlined-reference-material pattern. | 4 / 5 |
Total | 18 / 20 Passed |