Official agent skill

Nvidia Ontology Query

by NVIDIA in NVIDIA/skills

Query Auto Ontology and validate generated SQL, rows, and answers.

OfficialApache-2.0Auto-check passedDatabases

Install Nvidia Ontology Query

skills CLI
$ npx skills add NVIDIA/skills --skill nvidia-ontology-query -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install NVIDIA/skills nvidia-ontology-query --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nvidia-ontology-query .claude/skills/nvidia-ontology-query && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nvidia-ontology-query
GitHub stars
3.5k
Token cost
~1.7k tokens
SKILL.md length
703 words
Files
8 (incl. references, assets)
Skills in repo
386
Repo updated
First seen
Licence
Apache-2.0

At a glance

Query Auto Ontology and validate generated SQL, rows, and answers.

  • Works in 4 steps: Call readiness before asking a question. → Discover terms and confirm answerability… → Ask through MCP, or use the… → …
  • Grounded questions
  • SKILL.md covers Purpose, Prerequisites, Limitations and Instructions, plus 7 more sections
  • Needs AUTO_ONTOLOGY_API_TOKEN

What it does

Nvidia Ontology Query is an agent skill from NVIDIA/skills, published by the product's own GitHub organization. Query Auto Ontology and validate generated SQL, rows, and answers. Use for MCP or REST access, readiness, authentication, conversations, and grounded questions.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files and assets (for example `BENCHMARK.md`, `assets/runtime-contract.yaml` and `evals/evals.json`).

It sits in Databases, covering SQL and MCP servers. It works with NVIDIA AI Platform, Model Context Protocol and SQL. The repository describes itself as: Agent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end. The licence is Apache-2.0.

When your agent uses it

  • Grounded questions
  • Tasks that involve SQL
  • Tasks that involve MCP servers

Example prompts

  • “/nvidia-ontology-query”

Requirements

  • Python 3
  • A credential in AUTO_ONTOLOGY_API_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Call readiness before asking a question.
  2. Discover terms and confirm answerability through the semantic layer.
  3. Ask through MCP, or use the authenticated Next.js REST gateway as fallback.
  4. Validate material intent, SQL, rows, truncation, and prose before presenting

What it can do on your machine

Read from SKILL.md and the folder at commit dfdd080. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AUTO_ONTOLOGY_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nvidia Ontology Query loads about 1.7k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 703 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from NVIDIA/skills at commit dfdd080, republished under its Apache-2.0 licence (© NVIDIA). 703 words, ~1,653 tokens.

Download SKILL.mdSave it as .claude/skills/nvidia-ontology-query/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
nvidia-ontology-query
description
Query Auto Ontology and validate generated SQL, rows, and answers. Use for MCP or REST access, readiness, authentication, conversations, and grounded questions.
license
Apache-2.0
metadata.version
0.2.1
metadata.author
NVIDIA <opensource@nvidia.com>
metadata.tags
nvidia-ontology, mcp, api, agents, aiq
<!--
SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES.
All rights reserved.
SPDX-License-Identifier: Apache-2.0
-->

Auto Ontology grounded queries

Purpose

Query the current Auto Ontology implementation from an agent without prescribing a harness, SDK, or LangGraph template. Typed workflow artifacts, statuses, gates, and handoffs are in runtime-contract.yaml.

Prerequisites

Use a running Auto Ontology deployment and an authenticated MCP or REST client. If Auto Ontology is not running, use nvidia-ontology-setup first.

Limitations

This skill reads and validates answers. It does not expose FastAPI directly, write semantic definitions, publish governed results, or provide a raw-schema browser. Hand mutations and publication to nvidia-ontology-management.

Instructions

  1. Call readiness before asking a question.
  2. Discover terms and confirm answerability through the semantic layer.
  3. Ask through MCP, or use the authenticated Next.js REST gateway as fallback.
  4. Validate material intent, SQL, rows, truncation, and prose before presenting a claim-bearing answer.

Prefer MCP for reads

When the harness speaks MCP, use it. The handshake tool list is the live source of truth (mcp/auto_ontology_mcp/tools.py). Do not copy a tool table into the session; if the handshake and this skill disagree, trust the handshake.

Sequence (the server also advertises this so models do not jump straight to ask_question):

  1. check_readiness — compiled semantic layer and a live DB connection.
  2. search_terms — what the nouns mean here.
  3. check_answerable — cheap coverage check.
  4. ask_question — full text-to-SQL; tens of seconds; answer + SQL + rows (capped at 100 rows, with row_count / truncated).
  5. For a claim-bearing answer, validate material intent, generated SQL, returned rows, truncation, and prose using query-validation.md.

Everything on MCP reads. There is no MCP tool for raw databases, schemas, or columns on purpose. describe_table is the legitimate table view: terms and SQL attributes the table participates in.

Connect: AUTO_ONTOLOGY_API_URL is the web app. Run auto-ontology-mcp, point the client at …/mcp, user signs in. No token on the MCP server. Details: repository mcp/README.md and docs/mcp.md.

REST fallback and write handoff

When MCP is unavailable, public clients call the authenticated Next.js gateway, not FastAPI :3001. FastAPI trusts x-auto-ontology-user-id and must not be exposed. A direct FastAPI request without conversation_id is stateless; with conversation_id it requires that internal header.

Auth (any of these; resolved in one place):

  • Browser session cookie
  • API token: x-api-key: $AUTO_ONTOLOGY_API_TOKEN (Authorization: Bearer works for auto_ontology_… tokens too). Token acts as its owner.
  • OAuth bearer issued by Auto Ontology (MCP sign-in)
  • SSO id token (Authorization: Bearer <jwt>), e.g. AI-Q — see stack.md

Shapes: docs/openapi/auto-ontology-api.json. Do not scrape all ~87 operations. A write request hands off to nvidia-ontology-management; this skill does not turn a read-only question into a mutation.

Show full SKILL.md (291 more words)Show less
Chat

POST /api/chat/completions — SSE step / result / error / charts, then [DONE]. Permission chat:use; a request with conversation_id also needs conversation:write, or it gets 403.

  • Omit conversation_id for a one-shot (no history, no chart step).
  • Supply a client-generated UUID to create or continue a thread (needs chat:use and conversation:write).
  • Wait for [DONE] before the next turn; overlapping requests return 409 Conversation in progress.
  • A 404 on a conversation id means it belongs to another user.

Python (from the Auto Ontology README; no extra SDK):

python
import os
import requests

session = requests.Session()
session.headers["x-api-key"] = os.environ["AUTO_ONTOLOGY_API_TOKEN"]

terms = session.get("https://ontology.example.com/api/terms").json()

answer = session.post(
    "https://ontology.example.com/api/chat/completions",
    json={"question": "How many orders shipped last week?"},
)
# response is SSE, not a single JSON object

Open an API-created thread in the UI at /chat?focus=<conversation_id> when it belongs to the signed-in user.

Discovery (semantic layer, not a catalog browser)

MCP first. REST fallback:

  • GET /api/terms (query, skip, limit)
  • GET /api/terms/{term_id}
  • GET /api/exploration/tables/{table_id}/details
  • GET /api/exploration/graph

Writes and compile reset: nvidia-ontology-management.

Validate claim-bearing answers

Do not treat successful execution as sufficient evidence. Before presenting a decision-facing result, apply query-validation.md to check population, measure, unit, grain, joins, lineage, status, validity, rows, truncation, and answer prose. If a material constraint cannot be verified, return the gap rather than a stronger claim.

Empty or failed answers

ask_question / chat returned nothing useful → check_readiness (or GET /api/semantic-compilation/status) before rewriting the question. A named database is not proof SQL can execute. See nvidia-ontology-setup troubleshooting.

Examples

  • For a grounded count, run check_readiness, search_terms, check_answerable, and then ask_question.
  • If a response is truncated or violates measure grain, refuse the complete claim and follow query-validation.md.

Troubleshooting

For empty or failed answers, check readiness and compilation status before rephrasing. For REST errors, verify the public web origin, authentication, and conversation ownership before retrying.

See also

  • stack.md — AI-Q, Nemotron, cuOpt (what exists vs what partners wire)
  • query-validation.md — material intent, SQL, rows, and answer checks
  • nvidia-ontology-management — model, modify, and publish through the layer
  • nvidia-ontology-setup — bring-up and MCP OAuth discovery

© NVIDIA, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references, assets) in skills/nvidia-ontology-query of NVIDIA/skills.

  • SKILL.md
  • BENCHMARK.md
  • assets/runtime-contract.yaml
  • evals/evals.json
  • references/query-validation.md
  • references/stack.md
  • skill-card.md
  • skill.oms.sig

Open the folder on GitHubat commit dfdd080

Compare with similar skills

Nvidia Ontology Query next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nvidia Ontology Query compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nvidia Ontology Query this skillNVIDIA/skills3.5k—~1.7kAutomated safety check: PassApache-2.0
Sap Hana CLIsecondsky/sap-skills462—~3.1kAutomated safety check: NotesGPL-3.0
Tune Monitorsickn33/agentic-awesome-skills47k1 repos~3.3kAutomated safety check: PassApache-2.0
Dune MCP Skillholon-run/uxc116—~1.2kAutomated safety check: PassMIT
Semantic Analystsidequery/sidemantic129—~982Automated safety check: PassAGPL-3.0
Pytorch Clickhousepytorch/test-infra113—~2.8kAutomated safety check: PassCustom licence

Similar skills

  • Sap Hana CLI

    secondsky/sap-skills

    Assists with SAP HANA Developer CLI (hana-cli) for database development and administration.

    462 GitHub stars~3.1k tokensUpdated 4 days ago
    DatabasesAuto-check: notes
  • Tune Monitor

    sickn33/agentic-awesome-skills

    Analyze a Monte Carlo monitor and recommend config changes to reduce alert noise.

    47k GitHub starsUsed in 1 repo~3.3k tokens
    DatabasesAuto-check passed
  • Dune MCP Skill

    holon-run/uxc

    Use Dune MCP through UXC for blockchain table discovery, SQL query creation/execution, execution result retrieval, and visualization with help-first schema inspection, explicit auth binding, and…

    116 GitHub stars~1.2k tokensUpdated 24 days ago
    DatabasesAuto-check passed
  • Semantic Analyst

    sidequery/sidemantic

    Answer analytical, KPI, metric, trend, cohort, and business-performance questions through a Sidemantic semantic layer.

    129 GitHub stars~982 tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Pytorch Clickhouse

    pytorch/test-infra

    Load this FIRST whenever working with PyTorch CI data (any pytorch/ org repo), the torchci/HUD codebase, or the PyTorch HUD ClickHouse database.

    113 GitHub stars~2.8k tokensUpdated today
    DatabasesAuto-check passed
  • Aurora Dsql

    aws/agent-toolkit-for-aws

    Official

    Provisions and manages Aurora DSQL clusters, connects via psql or DSQL Connectors, manages schemas, runs queries, migrates from MySQL, diagnoses query plans, and develops apps on serverless…

    2.8k GitHub stars~9.6k tokensUpdated today
    Backend & APIsAuto-check passed

More from NVIDIA/skills

All 386 skills in this repo
  • Official

    A skill your agent uses when the user wants to deploy, run, debug, tear down, or call the REST API of the RTVI-CV 2D detection / tracking microservice.

    3.5k GitHub starsUsed in 1 repo~4.5k tokens
    Auto-check passed
  • Official

    Generates, validates, compares and explains HOLOLINK_def.svh macro files for the HSB IP, using bundled Python scripts and asking before it writes anything.

    3.5k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Official

    Runs and validates an end-to-end Mission Control demo in a locally installed Isaac Sim, with a Nova Carter robot driven through a Python server.

    3.5k GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Orchestrates defect image generation for PCBA, metal surface and glass inspection with NVIDIA Cosmos AnomalyGen on OSMO, from cold-start Day 0 to real-photo Day 1 labeling.

    3.5k GitHub stars~5k tokensUpdated today
    Auto-check: notes
  • Orchestrates video data augmentation and auto-labeling workflows on OSMO, from flow selection and preflight checks to submission, monitoring and output download.

    3.5k GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Official

    Runs NVIDIA TAO Data Services KPI analysis on object detection results, comparing predictions to ground truth and writing per-class precision, recall and AP to a CSV.

    3.5k GitHub stars~2.7k tokensUpdated today
    Auto-check: notes

Questions about Nvidia Ontology Query

What does Nvidia Ontology Query do?

Query Auto Ontology and validate generated SQL, rows, and answers. Nvidia Ontology Query is an agent skill from NVIDIA/skills, published by the product's own GitHub organization. Query Auto Ontology and validate generated SQL, rows, and answers.

When should I use Nvidia Ontology Query?

Nvidia Ontology Query fits situations like: grounded questions; tasks that involve SQL; tasks that involve MCP servers.

How do I install Nvidia Ontology Query in Claude Code?

Run `npx skills add NVIDIA/skills --skill nvidia-ontology-query -a claude-code`. Or copy the skill folder (skills/nvidia-ontology-query in NVIDIA/skills) into .claude/skills/nvidia-ontology-query in your project. Claude Code loads it when a task matches its description.

How do I install Nvidia Ontology Query in Codex?

Run `npx skills add NVIDIA/skills --skill nvidia-ontology-query -a codex`. Or copy the skill folder (skills/nvidia-ontology-query in NVIDIA/skills) into .agents/skills/nvidia-ontology-query in your project. Codex loads it when a task matches its description.

Can I use Nvidia Ontology Query in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NVIDIA/skills --skill nvidia-ontology-query -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nvidia-ontology-query, .gemini/skills/nvidia-ontology-query, .github/skills/nvidia-ontology-query and .opencode/skills/nvidia-ontology-query in your project.

What does Nvidia Ontology Query need to run?

Going by SKILL.md and its folder, Nvidia Ontology Query needs credentials named AUTO_ONTOLOGY_API_TOKEN. Our summary lists: Python 3; A credential in AUTO_ONTOLOGY_API_TOKEN.

Does Nvidia Ontology Query access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nvidia Ontology Query safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nvidia Ontology Query use?

Nvidia Ontology Query is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nvidia Ontology Query use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Nvidia Ontology Query?

Skills that share tags, products or a category with Nvidia Ontology Query: Sap Hana CLI (secondsky/sap-skills, 462 stars), Tune Monitor (sickn33/agentic-awesome-skills, 47k stars), Dune MCP Skill (holon-run/uxc, 116 stars) and Semantic Analyst (sidequery/sidemantic, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nvidia Ontology Query?

NVIDIA (a GitHub organization, an official publisher) maintains it in NVIDIA/skills, which has 3,546 GitHub stars. The repository holds 386 skills in this directory. The repository was last updated on October 9, 2026.

Source: NVIDIA/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.