n8n-node-builder

Scaffold and package custom n8n nodes for npm publishing.

1|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/RomainJeff/n8n-nodes-linkup --skill n8n-node-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n8n-node-builder
Source: https://github.com/RomainJeff/n8n-nodes-linkup/tree/main/.claude/skills/n8n-node-builder
Command: npx skills add https://github.com/RomainJeff/n8n-nodes-linkup --skill n8n-node-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through scaffolding, structuring, and publishing new n8n nodes as npm packages, reducing setup time and ensuring best practices.

Core Features & Use Cases

  • Declarative vs programmatic styles for node development
  • CLI-based scaffolding, file structure, and codex generation
  • End-to-end publishing readiness including credentials, linting, and versioning

Quick Start

Run the scaffold script to initialize your own n8n node package and start developing.

Frequently Asked Questions about n8n-node-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold and package a custom n8n node for npm publishing?

Scaffolding a custom n8n node for npm publishing involves generating the correct file structure, configuring credentials, creating codex files, and preparing an npm-ready package.json. This enforces linter-ready layouts and best practices for community node distribution.

What is the difference between declarative and programmatic styles in n8n node development?

Declarative and programmatic styles are two approaches for building n8n nodes. Declarative nodes use configuration for simple API mappings, while programmatic nodes allow custom logic execution, giving developers flexibility in how they implement workflow automation actions.

Do I need a codex file when building an n8n community node?

Yes, generating a codex file is required when building an n8n community node. It provides the necessary metadata and documentation structure that n8n uses to integrate your custom node properly into the workflow automation platform.

What's the best way to set up an n8n node project for npm publishing?

The best way to set up an n8n node project is using a CLI-based scaffolding script that initializes the package layout, adds SVG icons, sets up versioning, and ensures linting readiness. This guarantees your project meets npm publishing standards.

Can I include custom credentials in my n8n community node package?

Yes, you can include custom credentials in your n8n node package. The scaffolding process guides you through defining and configuring credentials so your node can securely authenticate with external services when published to npm.