n8n-architect

Use when the user explicitly wants to create, edit, validate, sync, or troubleshoot n8n workflows, asks about n8n nodes or automation, or wants to use n8n-as-code in the current context root.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%Weight 40%Scale 1-3

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

Highly actionable and clearly sequenced with strong validation discipline, but the skill is verbose with repeated guidance and monolithic where progressive disclosure into reference files would help.

Suggestions

De-duplicate repeated guardrails (API-key printing, two-attempt stop, do-not-invent) into a single "Universal Rules" section referenced once instead of restating them per section.

Extract the long Optional Native n8n MCP Assist routing policy and the Workflow Authoring Rules into separate reference files under references/, linking to them from SKILL.md to improve progressive disclosure.

Collapse the MCP section's redundant bullet list and use-case routing examples into one consolidated routing table to recover token budget.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and avoids explaining generic concepts, but it is padded with restated guidance ("Do not print API keys", "Stop after two attempts", and "Do not invent..." each recur) and the MCP section repeats routing rules as both bullet lists and use-case examples, so it could be tightened.	2 / 3
Actionability	Provides copy-paste-ready commands with exact flags and executable TypeScript snippets (e.g., env status --json, push --verify, the @workflow/@node structure), fully concrete rather than descriptive.	3 / 3
Workflow Clarity	Multi-step processes are explicitly sequenced (Bootstrap Order 1-9, Operating Loop 1-11, Testability Protocol 1-4) with validation checkpoints and feedback loops for risky/conflict operations.	3 / 3
Progressive Disclosure	Sections are well organized, but the ~519-line body is monolithic with no bundle files and no signaled references to separate materials, even though the MCP routing policy, authoring rules, and knowledge commands are large enough to split out.	2 / 3
	Total	10 / 12 Passed

Description

100%Weight 40%Scale 1-3

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 with concrete actions, natural trigger terms, and an explicit Use-when clause occupying a distinct niche. Voice is third-person/imperative, so no voice penalty applies.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("create, edit, validate, sync, or troubleshoot n8n workflows"), matching the anchor for several specific concrete actions rather than a single named action.	3 / 3
Completeness	Explicitly answers what (create/edit/validate/sync/troubleshoot workflows) and when ("Use when the user explicitly wants to..."), satisfying the both-what-and-when anchor; not capped at 2 because the trigger clause is present.	3 / 3
Trigger Term Quality	Natural user-facing terms are well covered ("n8n workflows", "n8n nodes", "automation", "n8n-as-code"), the phrasings a user would actually say when needing this skill.	3 / 3
Distinctiveness Conflict Risk	Tightly scoped to n8n-specific triggers ("n8n nodes", "n8n-as-code"), a clear niche unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (520 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: EtienneLescot/n8n-as-code
Path: packages/skills/src/agent-skills/n8n-architect/SKILL.md
Commit: 878d54d

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

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.