Official agent skill

Workflow Builder

by n8n-io in n8n-io/n8n

Load before calling build-workflow. An agent skill from n8n-io/n8n.

OfficialCustom licenceAuto-check: warningsProductivity & Automation

Install Workflow Builder

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add n8n-io/n8n --skill workflow-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install n8n-io/n8n workflow-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/n8n-io/n8n.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/@n8n/instance-ai/skills/workflow-builder .claude/skills/workflow-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workflow-builder
GitHub stars
207k
Token cost
~15k tokens
SKILL.md length
7,525 words
Files
11 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Load before calling build-workflow. An agent skill from n8n-io/n8n.

  • Works in 3 steps: Knowledge base — consult before → Runtime skills — when another skill… → Official n8n docs — for credential…
  • 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)
  • SKILL.md covers Routing, Early service connections, Repair Strategy and Escalation, plus 21 more sections
  • Calls node

What it does

Workflow Builder is an agent skill from n8n-io/n8n, published by the product's own GitHub organization. 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 workspaceexecutecommand, 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…

Its SKILL.md is about 15k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/compositional-workflows.md`, `references/config-eval-playbook.md` and `references/config-evals.md`).

It sits in Productivity & Automation, covering Workflow automation. It works with n8n, TypeScript and Model Context Protocol. The repository describes itself as: Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

When your agent uses it

  • 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)
  • Tasks that involve Workflow automation

Example prompts

  • “execute”
  • “/workflow-builder”

Requirements

  • A credential in YOUR_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Knowledge base — consult before
  2. Runtime skills — when another skill matches (e.g. data-table-manager,
  3. Official n8n docs — for credential setup, product features, hosting, or

What it can do on your machine

Read from SKILL.md and the folder at commit 60ad29f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workflow Builder loads about 15k tokens when it runs, and up to ~35k if it reads all its reference files. Until then it costs about 229 tokens; SKILL.md has 7,525 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~229
When it runs · the whole SKILL.md, loaded when a task matches
~15k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~35k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:1043
    ired, say plainly that setup is needed; do not tell the user to open a setup

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 7,525 words (~14,510 tokens).

“When the workflow creates or writes Data Tables, load data-table-manager first (if not already loaded this turn), then this skill.”

— opening of SKILL.md by n8n-io, Custom licence
name
workflow-builder
recommended_tools
read_file, write_file, edit_file, execute_command, build-workflow, workflows, nodes, data-tables, credentials, verify-built-workflow, executions

Read the full SKILL.md on GitHub

Files

SKILL.md and 10 other files (references) in packages/@n8n/instance-ai/skills/workflow-builder of n8n-io/n8n.

  • SKILL.md
  • references/compositional-workflows.md
  • references/config-eval-playbook.md
  • references/config-evals.md
  • references/credential-recipe-research.md
  • references/credential-setup-with-computer-use.md
  • references/error-workflows.md
  • references/model-selection.md
  • references/one-off-operations.md
  • references/post-build-flow.md
  • references/trigger-input-data-shapes.md

Open the folder on GitHubat commit 60ad29f

Compare with similar skills

Workflow Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workflow Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Builder this skilln8n-io/n8n207k—~15kAutomated safety check: WarnCustom licence
Skyvern Browser AutomationSkyvern-AI/skyvern23k—~1.9kAutomated safety check: PassAGPL-3.0
N8n ArchitectEtienneLescot/n8n-as-code1.6k—~7.3kAutomated safety check: WarnMIT
Build Audit Logsactivepieces/activepieces25k1 repos~5.9kAutomated safety check: PassCustom licence
n8n Multi-Instance Targetingczlonkowski/n8n-skills6.4k—~3.2kAutomated safety check: PassMIT
Agents Onboardingfazer-ai/agents118—~4.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

    23k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • N8n Architect

    EtienneLescot/n8n-as-code

    A skill your agent uses 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…

    1.6k GitHub stars~7.3k tokensUpdated today
    Productivity & AutomationAuto-check: warnings
  • Build Audit Logs

    activepieces/activepieces

    Build or review audit trails in TypeScript/JavaScript apps using evlog (pipelines, typed actions, denials, retention, compliance-style reviews).

    25k GitHub starsUsed in 1 repo~5.9k tokens
    Productivity & AutomationAuto-check passed
  • n8n Multi-Instance Targeting

    czlonkowski/n8n-skills

    Keeps an n8n MCP session pointed at the right n8n instance, with rules for discovering, switching and verifying the target before credential writes and for recovering from misroutes.

    6.4k GitHub stars~3.2k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed
  • Agents Onboarding

    fazer-ai/agents

    Conduz a jornada de onboarding 'do zero ao agente de atendimento' do fazer.ai agents num VPS, escolhendo o orquestrador de deploy (Tier A Coolify, B Portainer, C compose genérico para VM crua ou…

    118 GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Node Generator

    dafthunk-com/dafthunk

    Generate new workflow nodes with implementation, tests, and registry registration

    134 GitHub stars~2.5k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from n8n-io/n8n

All 12 skills in this repo
  • Official

    Debug failed or wrong-output workflow executions using executions tools.

    207k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • N8n CLI

    n8n-io/n8n

    Official

    Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance.

    207k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Official

    Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs.

    207k GitHub stars~550 tokensUpdated today
    Auto-check passed
  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Official

    Offer the three most common automations for a user as a single-choice card, from your own knowledge of their team and their apps, then build the one they choose once they confirm, or offer more.

    207k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Workflow Builder

What does Workflow Builder do?

Load before calling build-workflow. An agent skill from n8n-io/n8n. Workflow Builder is an agent skill from n8n-io/n8n, published by the product's own GitHub organization. Load before calling build-workflow.

When should I use Workflow Builder?

Workflow Builder fits situations like: 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); tasks that involve Workflow automation.

How do I install Workflow Builder in Claude Code?

Run `npx skills add n8n-io/n8n --skill workflow-builder -a claude-code`. Or copy the skill folder (packages/@n8n/instance-ai/skills/workflow-builder in n8n-io/n8n) into .claude/skills/workflow-builder in your project. Claude Code loads it when a task matches its description.

How do I install Workflow Builder in Codex?

Run `npx skills add n8n-io/n8n --skill workflow-builder -a codex`. Or copy the skill folder (packages/@n8n/instance-ai/skills/workflow-builder in n8n-io/n8n) into .agents/skills/workflow-builder in your project. Codex loads it when a task matches its description.

Can I use Workflow Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add n8n-io/n8n --skill workflow-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workflow-builder, .gemini/skills/workflow-builder, .github/skills/workflow-builder and .opencode/skills/workflow-builder in your project.

What does Workflow Builder need to run?

Going by SKILL.md and its folder, Workflow Builder needs the command-line tools its instructions call (node). Our summary lists: A credential in YOUR_API_KEY.

Does Workflow Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workflow Builder safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Workflow Builder use?

Workflow Builder has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Workflow Builder use?

About 15k tokens (SKILL.md is roughly 58k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 20k tokens, read only when the agent opens those files.

What are the alternatives to Workflow Builder?

Skills that share tags, products or a category with Workflow Builder: Skyvern Browser Automation (Skyvern-AI/skyvern, 23k stars), N8n Architect (EtienneLescot/n8n-as-code, 1.6k stars), Build Audit Logs (activepieces/activepieces, 25k stars) and n8n Multi-Instance Targeting (czlonkowski/n8n-skills, 6.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Builder?

n8n-io (a GitHub organization, an official publisher) maintains it in n8n-io/n8n, which has 206,847 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

Source: n8n-io/n8n on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.