binder-import

Import CSV, JSON, YAML, and Markdown data into Binder workspaces with schema-aligned field mapping.

39|5|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/mpazik/Binder --skill binder-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: binder-import
Source: https://github.com/mpazik/Binder/tree/main/skills/binder-import
Command: npx skills add https://github.com/mpazik/Binder --skill binder-import

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Binder Import removes the friction of manually recreating records from external files by turning CSV, JSON, YAML, and Markdown sources into Binder transactions that match your existing schema.

Core Features & Use Cases

  • Schema-aware ingestion: samples the source, inspects the target schema, and performs a gap analysis before generating transactions.
  • Field mapping with transforms: proposes how each source field maps to Binder fields, including required conversions (normalization, date parsing, enum/value normalization, and skipped fields when appropriate).
  • Duplicate-safe imports: checks for existing records using natural keys and generates updates vs creates to prevent duplicate data.
  • Batch dry-run workflow: generates transaction YAML in batches, dry-runs them first, and applies only after approval.

Quick Start

Import your external CSV or Markdown directory into your existing Binder workspace by asking the assistant to use binder-import to map fields, propose a transaction plan, and then generate and apply the batched imports after you confirm.

Frequently Asked Questions about binder-import

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

FAQPage Schema
How do I import CSV and JSON files into a Binder workspace?

To import CSV and JSON files into a Binder workspace, the system samples the source data, analyzes the target schema, and proposes a schema-aligned field mapping to generate batched create or update transactions.

How does schema mapping work for markdown ingestion?

Schema mapping for markdown ingestion works by analyzing single-structure Markdown files or directories with frontmatter, inspecting the target schema, and proposing field mappings with necessary normalization or date parsing before generating transactions.

Can I prevent duplicate records when importing data from external files?

Yes, you can prevent duplicate records during data import by checking existing data against natural keys, which allows the system to generate update transactions for existing records and create transactions for new ones.

What is the best way to safely apply batched data imports?

The best way to safely apply batched data imports is using a dry-run-first workflow that generates transaction YAML files for review, applying the batched create and update transactions only after explicit approval.

Does binder-import work with YAML lists and TSV files?

Yes, binder-import works with YAML lists and TSV files, alongside CSV, JSON arrays, and Markdown files, by sampling the source data to perform a gap analysis and propose schema-aligned field mappings.