workflow-builder
Builds and edits n8n workflows using the TypeScript SDK.
Identity proven by GitHub's verified organisation badge (n8n-io)
- Agents
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode
- License
- License unclear
- Pin
- a2c8142pinned Oct 9, 2026
- Context cost
- about 14,200 tokenswhen the skill loads
- GitHub stars
- 206,720on n8n-io/n8n
- Scripts
- None found
What it does
“Load before calling build-workflow. Default path for all single-workflow work: new one-off workflows, existing-workflow edits, verification repairs, and workflow-local data tables. Write or edit a workspace source file, run workflow-sdk validate via workspace_execute_command, then call build-workflow with filePath. When the workflow creates or writes Data Tables, load data-table-manager first, then this skill. Do not load planning or create-tasks first. Load planning only when multiple coordinated workflows or shared cross-task data tables require a dependency-aware task graph. Don't use this skill for explicit one-off tasks that can be done by a single node execution: load one-off-operations and run the node with nodes(action="execute"). Also load for a workflow's evaluations, model choices, credential setup, and post-build verification: this skill lists the references for those steps.”
Generated summary from the skill's own text
Builds and edits n8n workflows using the TypeScript SDK. Handles new workflow creation, modifications to existing workflows, node configuration, resource discovery, and credential setup before publishing.
When to use it
- Creating new n8n workflows from scratch with SDK code
- Editing existing saved workflows with targeted changes
- Setting up workflow nodes with proper credentials and resources
- Validating workflow source code before deployment
When not to
- Running one-off single-node operations without workflow structure
- Orchestrating multiple coordinated workflows with dependencies
- Repairs without inspecting actual execution errors first
Install
Restricted license: install from the publisher's repository and read its terms.
These commands install from the publisher's repository and need no account.
skills CLI
npx skills add n8n-io/n8n --skill workflow-builderInstalls from the repository's default branch, which may have changed since the commit we checked.
GitHub CLI 2.90 or later
gh skill install n8n-io/n8n workflow-builder@a2c814201354adaa324ba4343a7f68f9b4d2abd2Installs the commit we checked (a2c8142).
Copy by hand
Download the folder at a2c8142 and put it in .claude/skills/workflow-builder for Claude Code and in .agents/skills/workflow-builder for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.
Copy for your agent
A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.
Prompt
Install the agent skill "workflow-builder" by n8n. Source, pinned to commit a2c814201354adaa324ba4343a7f68f9b4d2abd2: https://github.com/n8n-io/n8n/tree/a2c814201354adaa324ba4343a7f68f9b4d2abd2/packages/@n8n/instance-ai/skills/workflow-builder 1. Download that folder at exactly this commit. Do not use the default branch. 2. Copy every file unchanged, keeping the folder structure, into .claude/skills/workflow-builder/ for Claude Code and .agents/skills/workflow-builder/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist. 3. Do not edit the files, and do not run any script in the folder unless I ask you to. 4. When you are done, list the files you copied and where you put them. Its license is restricted or not stated. Show me the license terms from the repository before you copy anything. Listing and checks: https://www.agentnative.dev/skills/n8n/workflow-builder
SKILL.md at the pin
The license of this skill does not let us show its files here.
Files
- SKILL.md58 KB · 58b9d591aca2
- references/
- compositional-workflows.md2.4 KB · 6ccfbef2e30e
- config-eval-playbook.md5.3 KB · 0f2ed1ff7dc5
- config-evals.md6.0 KB · 48c03b88c820
- credential-recipe-research.md4.3 KB · af8d51f13ca8
- credential-setup-with-computer-use.md3.6 KB · fea8f0e8d05c
- error-workflows.md1.9 KB · 4c42a847019a
- model-selection.md5.8 KB · 0be5308df7f0
- one-off-operations.md8.2 KB · 89cd44943063
- post-build-flow.md41 KB · fae5606e40f3
- trigger-input-data-shapes.md1.7 KB · c5685924e636
11 files, 139 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.
Skill folder on GitHub at a2c8142More from n8n
agent-builder
Agent Builder orchestrates the creation, modification, testing, and publishing of n8n Agents.
Claude Code, Codex, Cursor +3 · about 2.3K tokens · pinned 6 days ago
data-table-manager
This skill manages n8n Data Tables through creation, import, querying, and mutation operations.
Claude Code, Codex, Cursor +3 · about 2.1K tokens · pinned 6 days ago
debugging-executions
Debug workflow execution failures by inspecting failed nodes, re-running executions, and comparing expected versus actual values.
Claude Code, Codex, Cursor +3 · about 2.5K tokens · pinned 6 days ago
instance-awareness
This skill teaches the agent to resolve ambiguous requests by reading the instance's activity log and workflow history instead of asking the user to clarify.
Claude Code, Codex, Cursor +3 · about 1.3K tokens · pinned 6 days ago
intent-recognition
Classifies automation requests by determining which primitive owns the top-level control flow (workflow, agent, needs clarification, or out-of-scope) and…
Claude Code, Codex, Cursor +4 · about 6.9K tokens · pinned 6 days ago
n8n-cli
This skill enables agents to manage n8n workflows, credentials, executions, and instance resources via the n8n CLI command-line tool.
Claude Code, Codex, Cursor +4 · about 2.9K tokens · pinned 6 days ago
Related in Coding workflow
planning
This skill orchestrates multi-workflow projects with dependencies and shared data tables by creating a task graph in the orchestrator via the create-tasks tool.
by n8nOfficial publisher
Claude Code, Codex, Cursor +3 · about 2.4K tokens · pinned 6 days ago
progressive-building
This skill implements incremental workflow development for agents building or extending workflows.
by n8nOfficial publisher
Claude Code, Codex, Cursor +3 · about 1.4K tokens · pinned 6 days ago
remotion-upgrade
This skill upgrades Remotion and its related packages to the latest stable version.
by RemotionOfficial publisher
Claude Code, Codex, Cursor +3 · about 460 tokens · pinned 6 days ago
remotion-upgrade
This skill upgrades Remotion and related packages across a project, automatically detecting the package manager and workspaces.
by RemotionOfficial publisher
Claude Code, Codex, Cursor +3 · about 460 tokens · pinned 6 days ago
final-release-review
Audits Python SDK release candidates or plans against the previous release, comparing diffs for regressions, API changes, and version compatibility.
by OpenAIOfficial publisher
Contains scripts
Claude Code, Codex, Cursor +3 · about 5.4K tokens · pinned 6 days ago
implementation-final-review
This skill guides agents through a structured review process for completed implementation changes before final verification.
by OpenAIOfficial publisher
Contains scripts
Claude Code, Codex, Cursor +3 · about 1.9K tokens · pinned 6 days ago
Open roles at n8n
3 open roles on the jobs board
- Forward Deployed Engineer - US East Coast
Boston | California | Pennsylvania | New York | Massachusetts | Virginia | Colorado | New Jersey | Georgia | Texas (Remote)
- Forward Deployed Engineer - EMEA
Germany | Netherlands | Portugal | London Office | Ireland | United Kingdom | Spain (Remote)
- Agentic Engineering Platform Engineer
Remote (Europe) (Remote)