n8n-architect
Installation
SKILL.md
n8n Architect
Use this skill for all n8n-as-code work: workspace readiness, environments, managed local instances, tunnels, workflow authoring, validation, sync, push, and pull.
Use npx --yes n8nac as the primary interface. Use npx --yes @n8n-as-code/n8n-manager only for local managed runtime lifecycle, tunnels, and workflow presentation commands that are explicitly exposed by n8n-manager.
Context Root Protocol
- Treat the current context root as the directory containing
n8nac-config.json,AGENTS.md,.agents/skills, and the configuredworkflowsPath. - Generated context root hint: not embedded. Use the shell launch directory or the workspace path explicitly given by the user.
- Before any n8n work, first run
npx --yes n8nac 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
npx --yes n8nac env ...,npx --yes n8nac workspace ...,npx --yes n8nac 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 environment, project, or
workflowsPathfromAGENTS.md. - Before n8n work, resolve the effective context from the backend: