n8n Skills

Professional n8n skill for AI agents to design, audit, troubleshoot, document, and generate import-ready n8n workflow JSON.

This repository packages a reusable Skill for ChatGPT, Claude, and other agent systems. It helps agents behave like senior n8n workflow architects: designing reliable workflows, generating credential-safe JSON for import, auditing existing workflows, debugging failures, and documenting production automation systems.

What it does

Designs n8n workflows from scratch.
Generates Markdown specs plus optional import-ready workflow JSON.
Validates workflow JSON for common import and safety issues.
Audits workflows for security, reliability, observability, idempotency, and maintainability.
Produces node tables, data contracts, credential maps, setup steps, test payloads, and QA checklists.
Covers webhooks, HTTP APIs, pagination, retries, sub-workflows, queue mode, AI agent workflows, MCP patterns, and self-hosting concerns.

Why this exists

n8n workflows are easy to start and easy to make messy. AI agents often produce shallow automation plans or JSON that is not safe to import. This skill gives agents a stricter operating model:

no real secrets in workflow JSON,
import-oriented output structure,
deterministic node naming,
explicit data contracts,
error and retry paths,
idempotency by default,
production-readiness checklists.

Repository structure

n8n-skills-repo/
├── n8n-skills/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   ├── references/
│   └── scripts/
├── dist/skill.zip
├── examples/
├── docs/
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── SECURITY.md
└── CHANGELOG.md

Install

Upload dist/skill.zip to the skill system that supports custom Skills. The root skill folder is n8n-skills/ and the entrypoint is SKILL.md.

Example usage

Use n8n-skills. Build an import-ready n8n workflow JSON for a webhook that receives vendor invoice events, validates fields, calls an approval API, logs the result, and responds with a correlation ID. Include credential placeholders, setup steps, and a test payload.

Validation scripts

Validate an n8n workflow JSON:

python n8n-skills/scripts/validate_n8n_workflow_json.py examples/sample-importable-workflow.json

Validate a blueprint JSON:

python n8n-skills/scripts/validate_workflow_blueprint_json.py examples/sample-blueprint.json

Safety

This project is not affiliated with n8n. Do not commit real workflow exports that contain production credential names, private URLs, pinned production data, or sensitive payload examples.

License

MIT

N8n Skills

README