How do I install the N8n Builder skill?

Run npx skillmds@latest add diegosouzapw/n8n-builder-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is N8n Builder safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with N8n Builder?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is N8n Builder free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published N8n Builder?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

N8n Builder by diegosouzapw — Agent Skill

Name: N8n Builder
Author: diegosouzapw

N8n Builder

Expert n8n workflow builder that creates, deploys, and manages n8n workflows programmatically via the n8n REST API. Use when asked to create n8n workflows, automate n8n tasks, build automations, design workflow pipelines, connect services via n8n, or manage existing n8n workflows. Handles webhook flows, scheduled tasks, AI agents, database syncs, conditional logic, error handling, and any n8n node configuration.

diegosouzapw Updated Sep 21, 2026 54 repo stars

File contents

n8n Workflow Builder

Setup

Requires two environment variables:

N8N_URL — n8n instance URL (e.g. https://your-n8n.example.com)
N8N_API_KEY — n8n API key (Settings → API → Create API Key)

Workflow

Understand the automation — Clarify trigger (webhook/schedule/manual), data sources, processing logic, outputs, and error handling needs.
Design the workflow JSON — Build valid n8n workflow JSON following the schema in references/workflow-schema.md. Use patterns from references/workflow-patterns.md as templates.
Deploy via API — Use scripts/n8n-api.sh create <file> or pipe JSON to scripts/n8n-api.sh create-stdin.
Activate — Use scripts/n8n-api.sh activate <workflow_id> for trigger-based workflows.
Verify — List workflows to confirm deployment: scripts/n8n-api.sh list.

API Script Reference

# List all workflows
scripts/n8n-api.sh list

# Create workflow from JSON file
scripts/n8n-api.sh create /tmp/workflow.json

# Create from stdin
echo '{"name":"Test",...}' | scripts/n8n-api.sh create-stdin

# Get, activate, deactivate, delete, execute
scripts/n8n-api.sh get <id>
scripts/n8n-api.sh activate <id>
scripts/n8n-api.sh deactivate <id>
scripts/n8n-api.sh delete <id>
scripts/n8n-api.sh execute <id>

# List credentials and tags
scripts/n8n-api.sh credentials
scripts/n8n-api.sh tags

Building Workflow JSON

Every workflow needs: name, nodes[], connections{}, settings{}.

Every node needs: id, name, type, typeVersion, position, parameters.

Connections use source node display name as key, mapping outputs to target nodes.

For full schema, node types, and expression syntax → read references/workflow-schema.md For complete workflow examples (webhook, schedule, AI agent, DB sync, error handling) → read references/workflow-patterns.md

Key Rules

Always set "executionOrder": "v1" in settings
Node names must be unique within a workflow
Node IDs must be unique — use descriptive slugs like webhook1, code1
Position nodes starting at [250, 300], spacing ~200px horizontally
IF nodes have two outputs: index 0 = true, index 1 = false
Webhook workflows need respondToWebhook node if responseMode is responseNode
Credentials must exist in n8n before activation — check with scripts/n8n-api.sh credentials
Test before activating — use scripts/n8n-api.sh execute <id> for manual trigger workflows
Use continueOnFail: true on risky HTTP/API nodes, then check for errors downstream

Common Real Estate Workflows

Lead intake: Webhook → validate → dedupe → insert DB → notify Slack/SMS
Call follow-up: Schedule → query DB for completed calls → send SMS/email based on outcome
Drip campaign: Schedule → query leads by stage → send stage-appropriate email/SMS
CRM sync: Webhook → transform → update HubSpot/Salesforce + internal DB
Property alerts: Schedule → scrape/API listings → filter new → notify leads
AI qualification: Webhook → AI Agent (classify lead intent) → route to appropriate pipeline

---name: n8n-builder-2description: Expert n8n workflow builder that creates, deploys, and manages n8n workflows programmatically via the n8n REST API. Use when asked to create n8n workflows, automate n8n tasks, build automations, design workflow pipelines, connect services via n8n, or manage existing n8n workflows. Handles webhook flows, scheduled tasks, AI agents, database syncs, conditional logic, error handling, and any n8n node configuration.---# n8n Workflow Builder## SetupRequires two environment variables:- `N8N_URL` — n8n instance URL (e.g. `https://your-n8n.example.com`)- `N8N_API_KEY` — n8n API key (Settings → API → Create API Key)## Workflow1. **Understand the automation** — Clarify trigger (webhook/schedule/manual), data sources, processing logic, outputs, and error handling needs.2. **Design the workflow JSON** — Build valid n8n workflow JSON following the schema in `references/workflow-schema.md`. Use patterns from `references/workflow-patterns.md` as templates.3. **Deploy via API** — Use `scripts/n8n-api.sh create <file>` or pipe JSON to `scripts/n8n-api.sh create-stdin`.4. **Activate** — Use `scripts/n8n-api.sh activate <workflow_id>` for trigger-based workflows.5. **Verify** — List workflows to confirm deployment: `scripts/n8n-api.sh list`.## API Script Reference```bash# List all workflowsscripts/n8n-api.sh list# Create workflow from JSON filescripts/n8n-api.sh create /tmp/workflow.json# Create from stdinecho '{"name":"Test",...}' | scripts/n8n-api.sh create-stdin# Get, activate, deactivate, delete, executescripts/n8n-api.sh get <id>scripts/n8n-api.sh activate <id>scripts/n8n-api.sh deactivate <id>scripts/n8n-api.sh delete <id>scripts/n8n-api.sh execute <id># List credentials and tagsscripts/n8n-api.sh credentialsscripts/n8n-api.sh tags```## Building Workflow JSONEvery workflow needs: `name`, `nodes[]`, `connections{}`, `settings{}`.Every node needs: `id`, `name`, `type`, `typeVersion`, `position`, `parameters`.Connections use **source node display name** as key, mapping outputs to target nodes.For full schema, node types, and expression syntax → read `references/workflow-schema.md`For complete workflow examples (webhook, schedule, AI agent, DB sync, error handling) → read `references/workflow-patterns.md`## Key Rules- **Always set `"executionOrder": "v1"`** in settings- **Node names must be unique** within a workflow- **Node IDs must be unique** — use descriptive slugs like `webhook1`, `code1`- **Position nodes** starting at `[250, 300]`, spacing ~200px horizontally- **IF nodes** have two outputs: index 0 = true, index 1 = false- **Webhook workflows** need `respondToWebhook` node if `responseMode` is `responseNode`- **Credentials** must exist in n8n before activation — check with `scripts/n8n-api.sh credentials`- **Test before activating** — use `scripts/n8n-api.sh execute <id>` for manual trigger workflows- **Use `continueOnFail: true`** on risky HTTP/API nodes, then check for errors downstream## Common Real Estate Workflows- **Lead intake**: Webhook → validate → dedupe → insert DB → notify Slack/SMS- **Call follow-up**: Schedule → query DB for completed calls → send SMS/email based on outcome- **Drip campaign**: Schedule → query leads by stage → send stage-appropriate email/SMS- **CRM sync**: Webhook → transform → update HubSpot/Salesforce + internal DB- **Property alerts**: Schedule → scrape/API listings → filter new → notify leads- **AI qualification**: Webhook → AI Agent (classify lead intent) → route to appropriate pipeline

Frequently asked questions