DuckDB's Claude Code plugin: read CSV, JSON, Parquet, Excel or SQLite files, query them in SQL or plain English, and convert between formats.

How it works

Foe: Riddle Sphinx, a question your data hasn't answered yet.

Foes

  • Riddle Sphinx

Party · Context

  • AlchemistYour agent100/100
  1. Riddle Sphinx

    The Riddle Sphinx blocks the way.

    What really happensIt stands for a question your data hasn't answered yet.

    Alchemist: Context 100/100.

  2. Riddle

    The sphinx asks a riddle. A wrong guess costs dearly.

    What really happensAn answer guessed from a hunch instead of a query sends the work the wrong way.

    Alchemist takes 11. Alchemist: Context 89/100.

  3. DuckDB Skills

    The DuckDB relic wakes and lays out its scrolls.

    What really happensClaude Code loads the plugin. Skills run as /duckdb-skills:read-file, query, attach-db and convert-file, and read-file also fires when you mention a data file.

    Riddle Sphinx takes 14.

  4. DuckDB Skills

    One glance and the file gives up its columns and row count.

    What really happensread-file picks a DuckDB reader by extension (CSV, JSON, Parquet, Excel, SQLite and more), then shows the schema, the row count and 20 sample rows.

    Riddle Sphinx takes 12.

  5. Riddle

    The Riddle Sphinx uses Riddle.

    Alchemist takes 11. Alchemist: Context 78/100.

  6. DuckDB Skills

    The hero puts the riddle to the table and rows answer back.

    What really happensquery runs raw SQL or a plain English question against attached databases or files, written in DuckDB's Friendly SQL.

    Riddle Sphinx takes 29.

  7. DuckDB Skills

    The party keeps its open databases between casts.

    What really happensattach-db explores a .duckdb file and appends ATTACH statements to state.sql, so every later skill restores the same session.

    Riddle Sphinx takes 27.

  8. DuckDB Skills

    The hero recasts the file in the form the quest needs.

    What really happensconvert-file writes the data out as Parquet, CSV, JSON, Excel or another format through DuckDB.

    Riddle Sphinx takes 18. Riddle Sphinx falls.

  9. Victory

    The Riddle Sphinx falls.

Learn this spell

Claude Code

/plugin marketplace add duckdb/duckdb-skills
/plugin install duckdb-skills@duckdb-skills

Notes

Needs the DuckDB CLI on PATH. If it is missing, the skills offer install-duckdb, which needs the network, so a sealed trial arena works only with duckdb already installed. When an extension is missing (spatial, sqlite_scanner), read-file retries with INSTALL. Session state lives in .duckdb-skills/state.sql in the project or under ~/.duckdb-skills. duckdb-docs, s3-explore and remote reads use the network. read-memories searches past Claude Code session logs. Tested on macOS and Linux only. plugin.json version 0.2.4.

This spell has no recorded sessions in the curator's logs. Tried it? Send a spell report.