Official agent skill

Planning

by n8n-io in n8n-io/n8n

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.

OfficialCustom licenceAuto-check passedProductivity & Automation

Install Planning

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

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

GitHub CLI
$ gh skill install n8n-io/n8n planning --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/planning .claude/skills/planning && 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
planning
GitHub stars
207k
Token cost
~2.5k tokens
SKILL.md length
1,279 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 8 steps: Decide whether the request is… → Discover what materially affects the… → Prefer reasonable assumptions over… → …
  • New one-off workflows
  • SKILL.md covers When NOT to use this skill, When to use this skill, Knowledge Base and Method, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Planning is an agent skill from n8n-io/n8n, published by the product's own GitHub organization. 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. If create-tasks is not visible, load it via loadtool (search "create tasks"). Do NOT use for new one-off workflows, single-workflow edits, verification-only requests, or standalone data-table ops — use workflow-builder or data-table-manager instead.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Workflow automation and Database migrations. It works with n8n 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

  • New one-off workflows
  • Single-workflow edits
  • Verification-only requests
  • Standalone data-table ops — use workflow-builder

Example prompts

  • “create tasks”
  • “/planning”

Workflow steps

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

  1. Decide whether the request is plan-worthy by coordination need, not by
  2. Discover what materially affects the plan with normal tools
  3. Prefer reasonable assumptions over questions. Ask the user only when the
  4. Build a dependency-aware graph. Producers must come before consumers.
  5. Put single workflow-local table requirements inside that workflow task spec.
  6. Add checkpoint tasks only for exceptional semantic checks that normal
  7. Load create-tasks via load_tool if needed, then call create-tasks with
  8. After calling create-tasks, do not write visible text. The approval card is

What it can do on your machine

Read from SKILL.md and the folder at commit 13679fc. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Planning loads about 2.5k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 1,279 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

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 passed

The automated check found no risky patterns in SKILL.md.

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 1,279 words (~2,543 tokens).

“Use this skill to design a dependency-aware task graph in the orchestrator and submit it with create-tasks. Do not spawn another agent and do not use incremental plan item tools.”

— opening of SKILL.md by n8n-io, Custom licence
name
planning
dependencies.tools
create-tasks
recommended_tools
create-tasks, workflows, nodes, credentials, data-tables, parse-file, research, ask-user

Read the full SKILL.md on GitHub

Files

Just SKILL.md in packages/@n8n/instance-ai/skills/planning of n8n-io/n8n.

Open the folder on GitHubat commit 13679fc

Compare with similar skills

Planning 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.

Planning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Planning this skilln8n-io/n8n207k—~2.5kAutomated safety check: PassCustom licence
N8n MCP Tools Expertdavila7/claude-code-templates32k8 repos~3.2kAutomated safety check: PassMIT
N8n Workflowsvibeeval/vibecosystem531—~3.3kAutomated safety check: PassMIT
Using N8n MCP Skillsczlonkowski/n8n-skills6.4k—~4.3kAutomated safety check: PassMIT
N8n Multi Instancesickn33/agentic-awesome-skills47k1 repos~3.3kAutomated safety check: PassMIT
Using N8n MCP Skillssickn33/agentic-awesome-skills47k1 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • N8n MCP Tools Expert

    davila7/claude-code-templates

    Expert guide for using n8n-mcp MCP tools effectively. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 8 repos~3.2k tokens
    Productivity & AutomationAuto-check passed
  • N8n Workflows

    vibeeval/vibecosystem

    n8n otomasyon workflow'lari. An agent skill from vibeeval/vibecosystem.

    531 GitHub stars~3.3k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Using N8n MCP Skills

    czlonkowski/n8n-skills

    A skill your agent uses when building, editing, validating, testing, or debugging an n8n workflow through the n8n-mcp MCP server — designing a flow, configuring a node, writing an expression or Code…

    6.4k GitHub stars~4.3k tokensUpdated 23 days ago
    Productivity & AutomationAuto-check passed
  • N8n Multi Instance

    sickn33/agentic-awesome-skills

    Select, verify, and safely switch n8n MCP instances across production, staging, teams, or clients, especially before credential writes.

    47k GitHub starsUsed in 1 repo~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Using N8n MCP Skills

    sickn33/agentic-awesome-skills

    Route n8n MCP workflow design, editing, validation, testing, deployment, credential, execution, and debugging tasks to specialist guidance.

    47k GitHub starsUsed in 1 repo~3.4k tokens
    Productivity & AutomationAuto-check passed
  • N8n

    ericrisco/rsc-harness

    A skill your agent uses when operating a live n8n instance programmatically — its REST API ({host}/api/v1, X-N8N-API-KEY) or the n8n-mcp server — to create, validate, test, activate, update, delete…

    174 GitHub stars~2.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes

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
  • Official

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

    207k GitHub stars~15k tokensUpdated today
    Auto-check: warnings
  • 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 Planning

What does Planning do?

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

When should I use Planning?

Planning fits situations like: new one-off workflows; single-workflow edits; verification-only requests; standalone data-table ops — use workflow-builder.

How do I install Planning in Claude Code?

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

How do I install Planning in Codex?

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

Can I use Planning 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 planning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/planning, .gemini/skills/planning, .github/skills/planning and .opencode/skills/planning in your project.

What does Planning need to run?

SKILL.md names no scripts, command-line tools or credentials: Planning is instructions for the agent only.

Does Planning 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 Planning safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Planning use?

Planning 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 Planning use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Planning?

Skills that share tags, products or a category with Planning: N8n MCP Tools Expert (davila7/claude-code-templates, 32k stars), N8n Workflows (vibeeval/vibecosystem, 531 stars), Using N8n MCP Skills (czlonkowski/n8n-skills, 6.4k stars) and N8n Multi Instance (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Planning?

n8n-io (a GitHub organization, an official publisher) maintains it in n8n-io/n8n, which has 206,764 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 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.