query

Convert natural-language requests into executable DuckDB SQL queries.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/nq-rdl/agent-extensions --skill query-nq-rdl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query
Source: https://github.com/nq-rdl/agent-extensions/tree/main/skills/duckdb/query
Command: npx skills add https://github.com/nq-rdl/agent-extensions --skill query-nq-rdl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables you to execute SQL queries against an attached DuckDB database or directly against local data files, supporting natural-language requests that require SQL generation.

Core Features & Use Cases

  • Treat user requests as SQL or natural-language queries.
  • Determine mode (ad-hoc vs session) based on state and data references.
  • Generate SQL from natural language with schema awareness and execution against DuckDB.
  • Execute queries and return results, with guidance on result size and safety checks.

Quick Start

Ask the AI to run a SQL query against your DuckDB database or a local data file.

Frequently Asked Questions about query

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

FAQPage Schema
How do I query a local data file using natural language?

To query a local data file using natural language, you can submit your request directly to the system. It generates schema-aware DuckDB SQL from your text, executes it against the file-backed data, and returns the results.

Can I run ad-hoc SQL queries against an in-memory DuckDB database?

Yes, you can run ad-hoc SQL queries against an in-memory DuckDB database. The system determines ad-hoc versus session mode based on your state and data references, executing your SQL directly with safety checks.

Does this approach require me to write SQL or can it generate queries from text?

This approach supports both raw SQL execution and natural-language query (NLQ) to SQL generation. It treats your input as either direct SQL or natural language, generating executable DuckDB queries with schema awareness.

What is the best way to execute SQL on local data files without a full database setup?

The best way to execute SQL on local data files without a full database setup is using DuckDB. This system processes file-backed datasets directly, handling query generation, execution, and result management with built-in safety checks.

Are there limitations when generating SQL from natural language for data analysis?

A key limitation when generating SQL from natural language for data analysis is result size and safety. The system enforces safety checks and provides guidance on result size to manage large outputs from your generated DuckDB queries.