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…
Generate new workflow nodes with implementation, tests, and registry registration
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dafthunk-com/dafthunk node-generator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/node-generator .claude/skills/node-generator && rm -rf skills-srcUse ~/.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/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .claude/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dafthunk-com/dafthunk node-generator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/node-generator .agents/skills/node-generator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .agents/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dafthunk-com/dafthunk node-generator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/node-generator .cursor/skills/node-generator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .cursor/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dafthunk-com/dafthunk.git --path .claude/skills/node-generator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dafthunk-com/dafthunk node-generator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/node-generator .gemini/skills/node-generator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .gemini/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dafthunk-com/dafthunk node-generatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/node-generator .github/skills/node-generator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .github/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dafthunk-com/dafthunk --skill node-generator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dafthunk-com/dafthunk node-generator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dafthunk-com/dafthunk.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/node-generator .opencode/skills/node-generator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "node-generator" agent skill from https://github.com/dafthunk-com/dafthunk/tree/main/.claude/skills/node-generator into .opencode/skills/node-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "node-generator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
node-generatorGenerate new workflow nodes with implementation, tests, and registry registration
Node Generator is an agent skill from dafthunk-com/dafthunk. Generate new workflow nodes with implementation, tests, and registry registration
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. It works with React, Cloudflare, TypeScript and n8n. The repository describes itself as: A workflow execution platform built on top of the fantastic Cloudflare infrastructure. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 66be308. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
pnpmFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Node Generator loads about 2.5k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 521 words of instructions outside code blocks.
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.
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.
The full file from dafthunk-com/dafthunk at commit 66be308, republished under its MIT licence (© dafthunk-com). 521 words, ~2,471 tokens.
.claude/skills/node-generator/SKILL.md (or your agent's skills folder).Generate workflow nodes for Dafthunk: research requirements, create implementation and tests, register in the node registry.
When a user requests a new node, research first, then present a complete specification for confirmation.
Research the functionality:
apps/api/package.json or search npm for the latest versionCheck existing patterns:
packages/runtime/src/nodes/<category>/ for similar nodesDraft complete requirements:
Present for confirmation:
Based on [library/API/functionality], here's the proposed node:
**Name**: [Node Name]
**ID**: `node-id`
**Category**: category
**Icon**: icon-name
**Inputs**:
- `inputName` (type, required/optional): Description
**Outputs**:
- `outputName` (type): Description
- `metadata` (type, hidden): Description
**Dependencies**:
- package-name@^version
**Tags**: Category, Tag1, Tag2
Does this match your requirements?Only ask for information you cannot reasonably infer or research. The goal is to present a complete, research-backed specification that the user only needs to approve or tweak.
File: packages/runtime/src/nodes/<category>/<node-id>.ts
import { NodeExecution, NodeType } from "@dafthunk/types";
import { ExecutableNode, NodeContext } from "../../runtime/node-types";
export class [NodeClassName]Node extends ExecutableNode {
public static readonly nodeType: NodeType = {
id: "[node-id]",
name: "[Node Display Name]",
type: "[node-id]",
description: "[One-line description]",
tags: ["Category", "Tag1", "Tag2"],
icon: "[icon-name]",
documentation: "[Detailed documentation]",
inlinable: false,
asTool: false,
inputs: [
{
name: "[inputName]",
type: "[type]",
description: "[Description]",
required: true,
repeated: false,
},
],
outputs: [
{
name: "[outputName]",
type: "[type]",
description: "[Description]",
},
],
};
public async execute(context: NodeContext): Promise<NodeExecution> {
try {
const { input1, optionalInput = "default" } = context.inputs;
// Validate required inputs
if (input1 === null || input1 === undefined) {
return this.createErrorResult("Missing required input: input1");
}
if (typeof input1 !== "expectedType") {
return this.createErrorResult(
`Invalid input type for input1: expected expectedType, got ${typeof input1}`
);
}
// Handle repeated inputs (arrays)
if (Array.isArray(input1)) {
for (let i = 0; i < input1.length; i++) {
if (typeof input1[i] !== "string") {
return this.createErrorResult(
`Invalid input at position ${i}: expected string, got ${typeof input1[i]}`
);
}
}
}
// Main logic
const result = processInput(input1);
return this.createSuccessResult({ output1: result });
} catch (err) {
const error = err as Error;
return this.createErrorResult(`Error in [NodeName]: ${error.message}`);
}
}
}Defensive programming checklist:
execute throw — every failure path returns createErrorResult.
A thrown error still gets caught by the runtime, but the message loses the
node's context, so the user sees a bare "fetch failed" with no clue which
step broke.Conventions enforced across all nodes:
| Rule | Why |
|---|---|
id === type, kebab-case, matching the filename minus -node | type is the discriminator persisted in stored workflow graphs; renaming it breaks saved workflows |
| Descriptions (node, inputs, outputs) carry no trailing period when they are a single sentence | The UI renders them inline; multi-sentence text keeps its punctuation |
documentation only when it says something the description does not | Otherwise it is noise on the node's docs page — omit it |
public async execute(...), public static readonly nodeType | Matches every other node; no implicit-visibility members |
No any, anywhere | context.inputs is untyped, so narrow it at the top of execute with guards, not casts |
Every node registered in cloudflare-node-registry.ts | An unregistered node is dead code the editor can never surface |
Shared helpers — reach for these before writing your own:
nodes/json/json-access.ts — typed traversal of parsed JSON (getAtPath,
hasPath, readKey, writeKey, deepEqual, deepClone)nodes/geo/geo-input.ts — GeoJSON and unit guards (isGeoJSON,
isGeoJSONOf, isUnits, extractPosition)nodes/image/execute-photon-operation.ts — Photon lifecycle with guaranteed
resource cleanuputils/zod.ts + a static inputSchema — the preferred validation style for
new nodes; zodErrorMessage renders a readable failureFile: packages/runtime/src/nodes/<category>/<node-id>.test.ts
import { Node } from "@dafthunk/types";
import { describe, expect, it } from "vitest";
import { NodeContext } from "../../runtime/node-types";
import { [NodeClassName]Node } from "./<node-id>";
describe("[NodeClassName]Node", () => {
const createContext = (inputs: Record<string, unknown>): NodeContext => ({
nodeId: "[node-id]",
inputs,
getIntegration: async () => { throw new Error("No integrations in test"); },
env: {},
} as unknown as NodeContext);
it("should [perform expected operation]", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({ input1: "test value" }));
expect(result.status).toBe("completed");
expect(result.outputs?.output1).toBe("expected value");
});
it("should handle empty input", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({ input1: "" }));
expect(result.status).toBe("completed");
});
it("should return error for missing input", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({}));
expect(result.status).toBe("error");
expect(result.error).toContain("Missing required input");
});
it("should return error for invalid type", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({ input1: 123 }));
expect(result.status).toBe("error");
expect(result.error).toContain("Invalid input type");
});
it("should handle array of inputs", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({ input1: ["val1", "val2"] }));
expect(result.status).toBe("completed");
});
it("should return error for invalid element in array", async () => {
const node = new [NodeClassName]Node({ nodeId: "[node-id]" } as unknown as Node);
const result = await node.execute(createContext({ input1: ["valid", 123] }));
expect(result.status).toBe("error");
expect(result.error).toContain("position 1");
});
});Test coverage: Happy path, edge cases (empty/boundary values), error cases (missing/wrong types), array handling, type coercion (if applicable), domain-specific cases.
File: apps/api/src/runtime/cloudflare-node-registry.ts
Add import (alphabetically within category):
import { [NodeClassName]Node } from "./<category>/<node-id>";Register in constructor (alphabetically within category):
this.registerImplementation([NodeClassName]Node);pnpm typecheck
pnpm --filter '@dafthunk/api' test <node-id>List files created, confirm registry registration, show test command, note any dependencies to install.
Repeated inputs (single value or array):
if (typeof values === "string") { /* handle single */ }
if (Array.isArray(values)) { /* validate each element */ }Number coercion:
const num = Number(input);
if (isNaN(num)) { return this.createErrorResult("Invalid number"); }Optional inputs:
const { required, optional = "default" } = context.inputs;External libraries:
try {
const result = library.function(input);
} catch (err) {
return this.createErrorResult(`Operation failed: ${(err as Error).message}`);
}© dafthunk-com, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .claude/skills/node-generator of dafthunk-com/dafthunk.
Open the folder on GitHubat commit 66be308
Node Generator 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Node Generator this skilldafthunk-com/dafthunk | 134 | — | ~2.5k | Automated safety check: Pass | MIT | |
| N8n ArchitectEtienneLescot/n8n-as-code | 1.6k | — | ~7.3k | Automated safety check: Warn | MIT | |
| Datadog Appdatadog-labs/agent-skills | 177 | — | ~744 | Automated safety check: Pass | MIT | |
| Skyvern Browser AutomationSkyvern-AI/skyvern | 23k | — | ~1.9k | Automated safety check: Pass | AGPL-3.0 | |
| Instagram Skillsupreme-gg-gg/instagram-cli | 2.2k | — | ~1.4k | Automated safety check: Pass | MIT | |
| n8n Code Node JavaScriptczlonkowski/n8n-skills | 6.4k | — | ~4.9k | Automated safety check: Pass | MIT |
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…
datadog-labs/agent-skills
Guides developers building Datadog Apps with TypeScript, React, the @datadog/apps scaffolder, and @datadog/vite-plugin.
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.
supreme-gg-gg/instagram-cli
How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.
czlonkowski/n8n-skills
Guides writing JavaScript in n8n Code nodes: picking an execution mode, reading input data, returning items, using built-in helpers and avoiding common errors.
czlonkowski/n8n-skills
Explains how to write native Python in n8n Code nodes, including the two input variables, blocked imports and fixes for common errors.
dafthunk-com/dafthunk
Generate new OAuth integration providers for Dafthunk with backend providers, type definitions, frontend configurations, and integration nodes
dafthunk-com/dafthunk
Generate workflow templates with coherent node graphs and integration tests
Works with
Categories
Generate new workflow nodes with implementation, tests, and registry registration. Node Generator is an agent skill from dafthunk-com/dafthunk.
Node Generator fits situations like: tasks that involve Workflow automation.
Run `npx skills add dafthunk-com/dafthunk --skill node-generator -a claude-code`. Or copy the skill folder (.claude/skills/node-generator in dafthunk-com/dafthunk) into .claude/skills/node-generator in your project. Claude Code loads it when a task matches its description.
Run `npx skills add dafthunk-com/dafthunk --skill node-generator -a codex`. Or copy the skill folder (.claude/skills/node-generator in dafthunk-com/dafthunk) into .agents/skills/node-generator in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dafthunk-com/dafthunk --skill node-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/node-generator, .gemini/skills/node-generator, .github/skills/node-generator and .opencode/skills/node-generator in your project.
Going by SKILL.md and its folder, Node Generator needs the command-line tools its instructions call (pnpm).
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.
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.
Node Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Node Generator: N8n Architect (EtienneLescot/n8n-as-code, 1.6k stars), Datadog App (datadog-labs/agent-skills, 177 stars), Skyvern Browser Automation (Skyvern-AI/skyvern, 23k stars) and Instagram Skill (supreme-gg-gg/instagram-cli, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
dafthunk-com (a GitHub organization) maintains it in dafthunk-com/dafthunk, which has 134 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 4, 2026.
Source: dafthunk-com/dafthunk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.