n8n
Complete n8n skill — workflow building, node configuration, JavaScript/Python code nodes, expression syntax, validation, MCP tools, credentials, administration, Docker deployment, backup/restore, inte
SKILL.mdskills/n8n/SKILL.md
GitHubn8n
Complete skill for building, managing, and administering n8n workflows.
How to Use This Skill
This skill covers 9 domains. Each has its own reference file with detailed guidance.
Workflow Building (from czlonkowski/n8n-skills)
| Domain | Reference | When to use |
|---|---|---|
| Workflow Patterns | czlonkowski/skills/n8n-workflow-patterns/SKILL.md | Building new workflows, choosing architecture (webhook, HTTP API, database, AI agent, scheduled) |
| Node Configuration | czlonkowski/skills/n8n-node-configuration/SKILL.md | Configuring nodes, understanding property dependencies, required fields by operation |
| Code — JavaScript | czlonkowski/skills/n8n-code-javascript/SKILL.md | Writing JS in Code nodes, $input/$json/$node syntax, $helpers.httpRequest(), DateTime |
| Code — Python | czlonkowski/skills/n8n-code-python/SKILL.md | Writing Python in Code nodes, _input/_json syntax, standard library, limitations |
| Expression Syntax | czlonkowski/skills/n8n-expression-syntax/SKILL.md | Writing {{ }} expressions, $json/$node variables, fixing expression errors |
| Validation | czlonkowski/skills/n8n-validation-expert/SKILL.md | Interpreting validation errors/warnings, false positives, validation profiles |
| MCP Tools | czlonkowski/skills/n8n-mcp-tools-expert/SKILL.md | Using n8n MCP tools effectively — tool selection, parameter formats, common patterns |
Additional Domains
| Domain | Reference | When to use |
|---|---|---|
| Credentials | credentials/SKILL.md | Credential types, REST API credential CRUD, HTTP Request auth modes, httpCustomAuth JSON format, predefinedCredentialType vs genericCredentialType |
| Administration | administration/SKILL.md | Instance operations the MCP doesn't cover — Docker, backup/restore, CLI commands, internal API, community packages, SSO, upgrades, troubleshooting |
Quick Decision: Which Tool to Use
| You want to... | Tool |
|---|---|
| Create/edit/delete workflows | MCP (n8n_create_workflow, n8n_update_partial_workflow) |
| Search nodes, get schema | MCP (search_nodes, get_node) |
| Validate workflow or node | MCP (n8n_validate_workflow, validate_node) |
| Auto-fix workflow issues | MCP (n8n_autofix_workflow) |
| Deploy a template | MCP (n8n_deploy_template) |
| Test/trigger a workflow | MCP (n8n_test_workflow) |
| Manage executions | MCP (n8n_executions) |
| Create/update credentials | Public REST API (/api/v1/credentials) |
| Test a credential | Internal API (POST /credentials/test) — see credentials |
| Install community packages | Internal API (POST /community-packages) — see administration |
| Export decrypted credentials | CLI (n8n export:credentials --decrypted) — see administration |
| Backup/restore database | CLI / Docker — see administration |
| Upgrade n8n | Docker — see administration |
Priority: MCP → Public API → Internal API → CLI → Docker/Infra.
Core Concepts (Quick Reference)
Webhook Data Access
// CRITICAL: webhook data is nested under .body
const data = $input.first().json.body; // NOT $input.first().json
Code Node Return Format
// MUST return array of {json: {...}} objects
return items.map(item => ({
json: { ...item.json, processed: true }
}));
Expression Syntax
{{ $json.fieldName }} // Current item field
{{ $node["NodeName"].json }} // Another node's output
{{ $now.toISO() }} // Current timestamp
{{ $env.MY_VAR }} // Environment variable
Credential Linking (in workflow JSON)
{
"credentials": {
"httpHeaderAuth": { "id": "CRED_ID", "name": "My API Key" }
}
}