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 SphinxHaze Poison Ward Insight Flicker Pinned Enraged
Party · Context
- AlchemistYour agent100/100Haze Poison Ward Insight Flicker Pinned Enraged
The Riddle Sphinx blocks the way.
What really happensIt stands for a question your data hasn't answered yet.
Alchemist: Context 100/100.
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.
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.
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.
The Riddle Sphinx uses Riddle.
Alchemist takes 11. Alchemist: Context 78/100.
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.
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.
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.
The Riddle Sphinx falls.
Learn this spell
Claude Code
/plugin marketplace add duckdb/duckdb-skills
/plugin install duckdb-skills@duckdb-skillsNotes
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.

