CtrlK
BlogDocsLog inGet started
Tessl Logo

n8n-docs-assistant

Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs. Load n8n-docs via load_tool before calling it (search "n8n docs" if not visible). Use when the user asks how to configure, set up, troubleshoot, or understand n8n behavior, especially credential setup questions opened from the credential modal.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, well-structured instruction skill with a clear numbered workflow and explicit fallback/validation guidance. The only lever for improvement is showing the tool-call syntax as a concrete example rather than prose.

DimensionReasoningScore

Conciseness

Lean ~40-line body that assumes Claude's competence: no generic explanations of what n8n or OAuth are, just operational guidance, so every token earns its place.

5 / 5

Actionability

Gives concrete, executable steps (load_tool, n8n-docs(action="lookup"), specific context fields, Source/Sources citation format); minor gap is that exact tool call syntax is described in prose rather than a copy-pasteable example block.

4 / 5

Workflow Clarity

Clear numbered Default Procedure with explicit sequencing and feedback checkpoints (read snippets before answering, prefer credential-specific pages, fallback guidance when docs lookup fails), plus validation of the answer via Source attribution.

5 / 5

Progressive Disclosure

Well-organized single-file skill under 50 lines with no bundle files and no need for external references, satisfying the simple-skill exception for a top score.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states both what the skill does and when to use it, with natural trigger phrasing tied to the n8n credential modal. Minor additional synonyms or concrete output actions could lift it from strong to perfect.

DimensionReasoningScore

Specificity

Lists several concrete capability areas (product, setup, credential, node, hosting, API, usage) and the concrete action 'answers...questions from current n8n docs', though it stops short of enumerating specific outputs like 'lookup credential setup steps'.

4 / 5

Completeness

Clearly answers both 'what' (answers n8n product/setup/credential/node/hosting/API/usage questions from current docs) and 'when' (explicit 'Use when the user asks how to configure, set up, troubleshoot...especially credential setup questions opened from the credential modal') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural trigger phrasing ('configure, set up, troubleshoot, or understand n8n behavior', 'credential setup questions opened from the credential modal') covering common user phrasings, missing a few synonyms but very close to comprehensive.

4 / 5

Distinctiveness Conflict Risk

Scoped tightly to n8n docs lookup with a distinctive trigger (credential modal context) and a required tool (n8n-docs via load_tool), giving it a clear niche with minimal conflict risk against other skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
n8n-io/n8n
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.