n8n-agentic-workflow-engineering - SKILL.md Agent Skill

name: n8n-agentic-workflow-engineering description: Use for community/self-hosted n8n workflow development with reuse-first, validation-first GitOps delivery

n8n Agentic Workflow Engineering

Overview

This skill set defines how agents build n8n workflows for self-hosted/community environments.

Core rules:

Reuse existing templates/examples before building from scratch.
Keep Git as source of truth.
Validate structure and run fixture tests before sync/promotion.
Pull/reconcile before editing when humans can edit live UI.

Skill Catalog

See skills/n8n/specs/skill-catalog.json.

Key Scripts

skills/n8n/scripts/reuse-discovery.js
skills/n8n/scripts/validate-workflow-envelope.js
skills/n8n/scripts/n8n-sync-pull.js
skills/n8n/scripts/n8n-sync-push.js
skills/n8n/scripts/n8n-smoke-test.js

Commands

node skills/n8n/scripts/reuse-discovery.js --request skills/n8n/tests/fixtures/reuse-request.json --catalog skills/n8n/specs/template-sources.json
node skills/n8n/scripts/validate-workflow-envelope.js --input skills/n8n/tests/fixtures/sample-workflow.json
node skills/n8n/scripts/n8n-sync-pull.js --mock-response skills/n8n/tests/fixtures/pull-response.json --output-dir skills/n8n/tests/fixtures/tmp-pull
node skills/n8n/scripts/n8n-sync-push.js --mock-existing skills/n8n/tests/fixtures/existing-workflows.json --input skills/n8n/tests/fixtures/local-workflows
node skills/n8n/scripts/n8n-smoke-test.js --deployment skills/n8n/tests/fixtures/deployment-summary.json --mock-list skills/n8n/tests/fixtures/smoke-list-response.json
node --test skills/n8n/tests/*.test.mjs

Live n8n Cloud/free account usage (API key):

N8N_BASE_URL="https://<your-subdomain>.app.n8n.cloud" N8N_API_KEY="<api-key>" node skills/n8n/scripts/n8n-sync-pull.js --output-dir n8n/workflows
N8N_BASE_URL="https://<your-subdomain>.app.n8n.cloud" N8N_API_KEY="<api-key>" node skills/n8n/scripts/n8n-sync-push.js --input n8n/workflows
N8N_BASE_URL="https://<your-subdomain>.app.n8n.cloud" N8N_API_KEY="<api-key>" node skills/n8n/scripts/n8n-smoke-test.js --deployment n8n/deploy/last-deployment.json --require-active

Both sync scripts run in dry-run mode by default. Add --apply to execute changes.

Delivery Guidance

Use n8n-sync-pull before edits in co-edit environments.
Use n8n-sync-push only after validation + tests pass.
Keep production pull-only in normal operation.