duckdb-analyst

Query local Parquet files with DuckDB and return SQL statements.

94|7|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/jin-bo/agentao --skill duckdb-analyst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckdb-analyst
Source: https://github.com/jin-bo/agentao/tree/main/examples/data-workbench/.agentao/skills/duckdb-analyst
Command: npx skills add https://github.com/jin-bo/agentao --skill duckdb-analyst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the hassle of manually querying Parquet data files, ensuring you always have full visibility into the exact SQL logic used to generate every analytical result, with no hidden or unverified query steps.

Core Features & Use Cases

  • DuckDB-Powered Analysis: Run fast, efficient analytical queries directly on Parquet files in the read-only ./data directory without needing to set up a separate database instance.
  • Full SQL Transparency: Every query result is paired with the exact SQL statement executed, so you can audit, verify, or modify the query logic as needed.
  • Use Case: If you have a folder of sales Parquet files, use this Skill to quickly calculate total revenue by product, filter for top-performing regions, or identify year-over-year trends without writing boilerplate data loading code.

Quick Start

Use the duckdb-analyst skill to calculate the total revenue per product from the sales.parquet file in the ./data directory.

Frequently Asked Questions about duckdb-analyst

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

FAQPage Schema
How do I query Parquet data files with SQL without setting up a database?

You can query Parquet data files with SQL directly using the DuckDB query engine. This approach eliminates the need for a separate database instance, allowing you to run fast analytical queries for data exploration and aggregation immediately.

Can I see the exact SQL statements used for my Parquet data analysis?

Yes, full SQL transparency is provided for all generated results. Every query result is paired with the exact SQL statement executed, enabling you to audit, verify, or manually modify the analytical query logic as needed.

How do I perform ad-hoc data exploration and profiling on local Parquet files?

Ad-hoc data exploration and profiling on local Parquet files is performed by applying analytical queries to structured datasets. This includes tasks like sales analytics, log analysis, and trend identification directly within the read-only ./data directory.

Are there row limits or restrictions when running analytical queries on Parquet files?

Yes, analytical queries enforce a default 1000-row limit on outputs. Additionally, destructive SQL operations such as DELETE, UPDATE, and DROP are prohibited to ensure safe, read-only data exploration on your Parquet files.

What is the best way to calculate total revenue and identify trends from sales Parquet files?

The best way to calculate total revenue and identify trends from sales Parquet files is using an analytical query engine. You can aggregate total revenue per product, filter top-performing regions, or identify year-over-year trends without writing boilerplate data loading code.

Do I need to manually load local Parquet data before running analytical queries?

No, you do not need to manually load local Parquet data before running analytical queries. The DuckDB query engine reads Parquet files directly from the read-only ./data directory, bypassing the need for boilerplate data loading code.