Agent Skill
NoQL ships as an Agent Skill: a folder with SKILL.md plus on-demand references. Upload or copy it into Claude, Claude Code, Cursor, or any other agent that implements the standard so the model writes valid NoQL instead of generic SQL.
The zip is noql/ at the root (not loose files), which is the layout Claude expects.
Install
Claude.ai — Customize → Skills → upload noql.zip. Enable the skill. Code execution must be on.
Claude Code — unzip into ~/.claude/skills/noql/ (personal) or .claude/skills/noql/ (this repo).
Cursor — unzip into ~/.cursor/skills/noql/ (personal) or .cursor/skills/noql/ (this repo).
The folder name must stay noql to match the name field in SKILL.md.
Package contents
noql.zip
└── noql/
├── SKILL.md # metadata + core syntax, quoting, caveats
├── LICENSE.txt
└── references/
├── joins.md
├── arrays.md
├── objects.md
├── functions.md
└── examples.md
SKILL.md is loaded when the skill activates. Reference files are read only when the task needs joins, arrays, objects, or the function catalog.
Source: skill/noql. Human-readable syntax docs: SQL Syntax.