Skip to content
SkillModel-led3,645 tokens in use

n8n Binary and Data

A guide to files in n8n: where bytes live, how to read and write them, how to stop transforms from dropping them, and how to pass files to agent tools and chat apps.

6,686 stars on the repository MIT Licenseczlonkowski/n8n-skills · skills/n8n-binary-and-data
/plugin install czlonkowski/n8n-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing n8n Binary and Data costs

134tokens idle
3,645tokens in use
12,472tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure19/25
  • Examples12/15
  • Output10/15
  • Size15/15
  • Resources12/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity88
  • Maintenance92
  • Community60
  • Maturity36
  • Momentum40

n8n Binary and Data is a skill for Claude that explains the two slots every n8n item carries: $json for structured data and $binary for file bytes. It covers how downloads, uploads and attachments populate $binary, and how a Code node reads and writes bytes.

It also covers the failures that validation does not catch: a Code node or Edit Fields step that silently drops the file, an AI agent tool that cannot receive binary, and chat apps that need an image URL.

What You Get

  • The $json and $binary item shape, with binary property names and the default data key
  • Code node snippets that read bytes with getBinaryDataBuffer and write a new binary slot
  • Two ways to keep a file through JSON-only nodes: pass-through options and a Merge in combineByPosition mode
  • An inbound and outbound pattern for files that an AI agent tool must read or produce
  • Guidance on picking storage for chat images and using signed URLs for sensitive files
  • Reference files for binary basics, agent tool binary, Merge and CDN needs

Common Use Cases

  • Attaching a downloaded PDF to an email after an Edit Fields step
  • Letting a chat agent work on an uploaded file through a tool
  • Posting a generated image into Slack or Telegram
  • Debugging an HTTP Request node whose download arrives as garbled text

What Makes It Unique

It treats lost binary as a silent failure that validation cannot see, and explains how to confirm presence by reading the execution. It also documents the agent tool binary boundary in both directions, with a storage-key pattern, which general n8n guides tend to skip. It asks which storage the user already has before it suggests a provider.

Under The Hood

The skill is instructions and four reference markdown files, with no scripts. It tells Claude to look up node settings through the n8n-mcp tools, run test executions and read executions from your n8n instance to check that the binary slot survived. The code it shows runs inside n8n Code nodes, where it reads and writes file bytes held by the workflow. The storage patterns call out to object storage or drive services you choose.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers