A skill is a set of local instructions to follow that is stored in a SKILL.md file.
- geosql: Build and optionally execute cost-safe Overture Maps SQL for BigQuery with dry-run budget checks. Use when users need map-ready SQL, executed results, or over-budget fallback options. (file: geosql/SKILL.md)
- Trigger rules: If the user names the skill (
$geosql) or the request clearly matches its description, use it for that turn. - Loading: Open
geosql/SKILL.mdand follow it. - Scope: Do not carry this skill across turns unless re-mentioned or clearly required by the new request.
- Claude Skills docs: https://code.claude.com/docs/en/skills
- Agent Skills open standard: https://agentskills.io
- Keep frontmatter concise: use short
description, includeargument-hintwhen slash arguments are expected. - Keep one canonical source per artifact: no duplicate
SKILL.mdor script logic copies. - Put deterministic execution logic in
scripts/and reference those scripts explicitly fromSKILL.md. - Keep instructions focused and scannable; move deep details to supporting files only when needed.
This skill ships NO agent-run scripts. Any reusable helper goes into the dekart CLI. Keep skills/geosql/scripts/ empty.