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.
Best for n8n workflow developersWorks with GitHub
⌘source
- author
@EtienneLescot- language
- TypeScript
★1.1kstars
136forks
May 7, 2026
✦overview.md
Key Features
- ·Create and edit n8n workflows as code
- ·Validate and sync workflows with n8n instance
- ·Run workspace status commands
- ·Context root protocol for consistent execution
- ·Integration with AGENTS.md for command overrides
- ·Supports pull, push, validate, test operations
Use Cases
- →A developer wants to create a new n8n workflow from scratch using code.
- →An engineer needs to validate a set of workflows before syncing to production.
- →A team lead wants to sync workflow changes from a Git repository to an n8n instance.
- →A developer troubleshooting a workflow error needs to run tests and checks.
Best for
- ✓n8n workflow developers
- ✓automation engineers
- ✓CI/CD pipeline integration
Not ideal for
- !n8n instance management
- !one-time scripting without context
FAQs
name
n8n-architect
description
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.
n8n Architect
Use this skill for workflow engineering. Use the n8n-manager skill for instance, auth, runtime, tunnel, project-default, credential infrastructure, or workflow presentation work.
Context Root Protocol
- Treat the current context root as the directory containing
n8nac-config.json,AGENTS.md,.agents/skills, and the workflow sync folder. - {{N8NAC_CONTEXT_ROOT_HINT}}
- Before any n8n work, first run
{{N8NAC_CMD}} update-aifrom the context root, then readAGENTS.md.update-aiis designed to create or refresh the n8n-as-code block without destroying existing user or agent instructions. - Use the exact
n8nac commandandn8n-manager commandlisted inAGENTS.md. Those context-root commands override the portable examples in this skill. - Run every
{{N8NAC_CMD}} workspace ...,{{N8NAC_CMD}} list,pull,push,validate,test, andupdate-aicommand from the context root unless the user explicitly gives another context root. AGENTS.mdis bootstrap context only, not a source of configuration truth.- Do not infer instance, project, sync folder, or workflow directory from
AGENTS.md.
$install
1-click copynpx skills add EtienneLescot/n8n-as-code --skill n8n-architectSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
2/ 5
fairThe main idea is there, but the wording is messy and easy to misinterpret.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.