Content
85%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 tight, well-structured instruction skill: it specifies exact tool-call parameters, context fields, output citation format, and failure handling without padding. The only trims are the duplicated intro line and the under-specified search/read path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with no concept explanations, but the opening paragraph ('Use this skill when the user asks how to configure, set up, troubleshoot, or understand n8n behavior') nearly duplicates the frontmatter description and could be trimmed, matching anchor 4 rather than 5. | 4 / 5 |
Actionability | The primary path is executable with exact call syntax ('n8n-docs(action="lookup")', 'intent: "credential-setup"', named context fields, and a concrete citation format), but the 'search'/'read' alternative is only loosely specified ('Use search then read only when you need tighter control') without call syntax, matching anchor 4 (minor gaps) rather than 5. | 4 / 5 |
Workflow Clarity | The Default Procedure is a clearly sequenced 4-step workflow with an explicit checkpoint ('Read the returned document snippets before answering. If multiple pages were returned, prefer credential-specific pages') and an error-recovery fallback in the Missing Docs section, matching anchor 5. This is a non-destructive docs-lookup skill, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained with no bundle files, and organized into clear sections (Default Procedure, Credential Setup, Missing Docs); per the simple-skill scoring note, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 18 / 20 Passed |