aiq-research

name	aiq-research
description	Routes research questions to a reachable NVIDIA AI-Q Blueprint via scripts/aiq.py (health, /chat, async job poll, report). Use when the user asks for AI-Q/AIQ research or to query a trusted AIQ_SERVER_URL. Not for installing, deploying, Docker, Helm, or Blueprint troubleshooting (aiq-deploy). Never put credentials in the query text or fabricate answers if the backend fails.
license	Apache-2.0
permissions	{"env":["AIQ_SERVER_URL"],"network":["http://localhost:8000"]}
compatibility	Designed for Claude Code, OpenCode, Codex, and Agent Skills-compatible tools. Requires Python 3.11+ and network access to a running local AI-Q Blueprint server at `http://localhost:8000` by default. Non-local backends must be explicitly trusted by the user and granted by the host tool outside this public skill.
metadata	{"version":"2.1.1","author":"NVIDIA AI-Q Blueprint Team <[e-mail]>","github-url":"https://github.com/NVIDIA-AI-Blueprints/aiq","tags":["nvidia","aiq","blueprint","deep-research","research-agents","agent-skills"],"languages":["python","bash"],"domain":"research-agents"}
allowed-tools	Read Bash

AIQ Research Skill

When to Use

Use this skill to call a locally running NVIDIA AI-Q Blueprint server through the helper script at scripts/aiq.py.

Use this skill for research-shaped requests, including:

• "deep research on ..."
• "AIQ research ..."
• "research ..."
• "use AI-Q to answer ..."
• "ask AI-Q about ..."

Do not use this skill for install, deploy, start, stop, UI, CLI, Docker, Helm, or troubleshooting requests. Those belong to aiq-deploy.

Prerequisites

• Python 3.11+ available as python3 (or python on Windows PowerShell).
• A reachable local or self-hosted AI-Q Blueprint backend.
• AIQ_SERVER_URL set when the backend is not running at http://localhost:8000; non-local values must be trusted by the user before any query is sent.
• A backend configured with authentication disabled for this public helper, or a separate authenticated AI-Q skill for authenticated environments.
• Network access from the local machine to the AI-Q backend URL.
• Credentials configured in the backend environment, not in this skill. This public helper does not collect or manage API keys.

The helper script has no third-party Python package dependencies; it uses Python standard-library HTTP modules.

Procedure

Step 1 — Resolve the backend URL

Use AIQ_SERVER_URL when set. Otherwise try the default local backend at http://localhost:8000.

Run a health check before sending any research request:

python $SKILL_DIR/scripts/aiq.py health

Expected output: JSON from a reachable AI-Q health endpoint.

If health fails and no explicit AIQ_SERVER_URL was set, ask:

I do not see a reachable local AI-Q backend. Do you already have an AI-Q backend URL you want to use, or should I deploy a local Skill backend?

• If the user provides a URL, set AIQ_SERVER_URL for subsequent helper calls and rerun health.
• If the user wants local deployment, hand off to aiq-deploy and preserve the original research request.
• If a reachable backend returns 401 or 403, stop and explain that this public skill does not manage authentication. Ask the user to use an authenticated AI-Q skill or configure authentication for their environment.