Skip to content

narrative-io/narrative-skills-marketplace / plugins/narrative-common/skills/write-nql

write-nql

Verified

Write, validate, and (optionally) execute an NQL query against a Narrative dataset. Drafts the query from the user's question, runs `narrative_nql_validate` until it compiles, explains the query in plain English, and only runs it on explicit approval (or when invoked with `--run`). Use when: "write an NQL query for X", "query this dataset", "validate this NQL", "run NQL against dataset <id>", "how many rows match Y", "show me the top N records from <dataset>". (narrative-common)

references/HARNESS_FALLBACK.md.tmpl

View on GitHub
# Harness fallbacks

What to do when `narrative-mcp` is unavailable and when the harness
doesn't expose `AskUserQuestion`.

Never silently degrade. If a tool is unavailable, say so explicitly
in the explanation.

## `narrative-mcp` unavailable

- Ask the user to paste the dataset's schema (column names + types)
  and 10-25 sample rows.
- With that context pasted in, draft the query and apply the syntax
  rules above manually. You cannot validate without the server —
  add a global caveat in the explanation that the query has *not*
  been server-validated and the user should sanity-check before
  running it through the Narrative UI.
- Never silently degrade. If validation was skipped, say so
  explicitly.

## Waiting tools not available

{{SNIPPET:waiting-tools-fallback}}

## "AskUserQuestion" not available

{{SNIPPET:askuserquestion-fallback}}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall