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.