write-nql

Draft natural-language questions into validated NQL queries for Narrative datasets.

7|Updated May 18, 2026
One-click install
npx skills add https://github.com/narrative-io/narrative-skills-marketplace --skill write-nql
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-nql
Source: https://github.com/narrative-io/narrative-skills-marketplace/tree/main/plugins/narrative-common/skills/write-nql
Command: npx skills add https://github.com/narrative-io/narrative-skills-marketplace --skill write-nql

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafts natural-language questions into validated NQL queries against Narrative datasets, ensuring safe validation before execution.

Core Features & Use Cases

  • Automatically drafts NQL from user questions and validates it with the configured data plane and dataset context.
  • Explains the validated query in plain English and supports an opt-in run workflow to execute it.
  • Use cases include ad-hoc data exploration, dataset qualification, and creating repeatable analytic artifacts.

Quick Start

Provide a natural-language question like "Show me the top customers by revenue in the last quarter" and the skill will generate, validate, and (optionally) run the corresponding NQL.

Frequently Asked Questions about write-nql

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

FAQPage Schema
How do I turn natural-language questions into validated NQL queries?

To turn natural-language questions into validated NQL queries, provide a plain English prompt and the tool drafts NQL against your Narrative datasets. It validates the query using dataset context and data-plane scoping before any execution occurs.

What is NQL validation and why is it needed before running a query?

NQL validation checks generated queries against dataset context and the provider's data plane to ensure accuracy. It prevents execution errors by explaining the query in plain English and requiring user confirmation before running it with a materialized-view wrapper.

Can I use natural-language query generation for ad-hoc data exploration on Narrative datasets?

Yes, you can use natural-language query generation for ad-hoc data exploration on Narrative datasets. It drafts and validates NQL on demand, letting you explore data, qualify datasets, and create repeatable analytic artifacts without manual coding.

Does NQL execution require user confirmation before running?

Yes, NQL execution requires user confirmation before running. The tool explains the validated query in plain English and only proceeds with execution using a materialized-view wrapper and proper data-plane scoping after you explicitly opt in.

What's the best way to create repeatable analytic artifacts from plain English prompts?

The best way to create repeatable analytic artifacts from plain English prompts is to draft and validate NQL queries against your Narrative datasets. Once validated, the generated NQL serves as a repeatable artifact for ongoing analytical workflows.