chore(skills): trigger NVSkills CI validation (no-op) - #279
Closed
AjayThorve wants to merge 1 commit into
Closed
AjayThorve wants to merge 1 commit into
AjayThorve wants to merge 1 commit into
Conversation
Member
Author
|
/nvskills-ci |
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Enterprise Run ID: 📒 Files selected for processing (2)
📜 Recent review details⏰ Context from checks skipped due to timeout. (1)
|
| Path | Purpose |
|---|---|
src/aiq_agent/ |
Backend agent, FastAPI extensions, auth, observability, knowledge |
sources/ |
Data-source / tool packages (e.g. tavily_web_search, google_scholar_paper_search) |
configs/ |
Workflow YAML configs (e.g. config_cli_default.yml) |
frontends/ui/ |
Next.js / React / TypeScript / Tailwind / KUI web UI |
frontends/benchmarks/ |
Eval harnesses: freshqa, deepsearch_qa, deepresearch_bench |
deploy/ |
Docker Compose and Helm/Kubernetes assets; deploy/.env for secrets |
docs/source/ ... |
Files:
skills/aiq-deploy/SKILL.mdskills/aiq-research/SKILL.md
skills/aiq-deploy/**
⚙️ CodeRabbit configuration file
skills/aiq-deploy/**: ---
name: aiq-deploy
description: |
Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.
license: Apache-2.0
compatibility: |
Designed for Claude Code, OpenCode, Codex, and Agent Skills-compatible tools. Requires Git, network
access to GitHub, and one selected runtime path: Docker Compose v2 for the default local deployment,
Python 3.11+ and uv for local process or CLI mode, Node.js 20+ and npm for local web UI mode, or
kubectl 1.28+ and Helm 3.12+ for Kubernetes and Helm mode.
metadata:
version: "2.1.0"
author: "NVIDIA AI-Q Blueprint Team aiq-blueprint@nvidia.com"
github-url: "https://github.com/NVIDIA-AI-Blueprints/aiq"
tags:
- nvidia
- aiq
- blueprint
- deploy
- operations
- agent-skills
allowed-tools: Read BashAIQ Deploy Skill
Purpose
Use this skill to get a local or self-hosted NVIDIA AI-Q Blueprint server running and verified for use by
aiq-research.This skill owns setup, deployment, operational checks, troubleshooting, and shutdown. It does not run deep
research itself. After deployment is healthy, hand off the verified server URL toaiq-research.
The workflow stays explicit so deployment validation and handoff are repeatable across supported agent clients.Prerequisites
Users need:
- Access to clone or update
https://github.com/NVIDIA-AI-Blueprints/aiq.- Git available in the shell.
- One deployment runtime:
- Docker Engine with Docker Compose v2 for the default durable local deployment.
- Python 3.11+ and
uvfor local process or CLI mode.- Node.js 20+ and
npmfor local browser UI development mode.kubectl1.28+, Helm 3.12+, and access to a Kubernetes cluster for Helm mode.- Network access to GitHub, NVIDIA-hosted model endpoints, and any selected search provider.
- Credentials stored outside chat. Hosted-model usage requires
NVIDIA_API_KEY; web research requires at least
one supported s...
Files:
skills/aiq-deploy/SKILL.md
{skills/**,.agents/skills/**,.claude/skills/**,.github/skill-eval/**}
⚙️ CodeRabbit configuration file
{skills/**,.agents/skills/**,.claude/skills/**,.github/skill-eval/**}: Review Agent Skill and skill-eval changes for valid skill metadata, deterministic eval specs, safe handling of
credentials, and clear generated-output boundaries. Do not flag SKILL.md files for missing SPDX headers when the
entrypoint intentionally starts with YAML frontmatter.
Files:
skills/aiq-deploy/SKILL.mdskills/aiq-research/SKILL.md
skills/aiq-research/**
⚙️ CodeRabbit configuration file
skills/aiq-research/**: ---
name: aiq-research
description: |
Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.
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 athttp://localhost:8000by 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.0"
author: "NVIDIA AI-Q Blueprint Team aiq-blueprint@nvidia.com"
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 BashAIQ Research Skill
Purpose
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 toaiq-deploy.Prerequisites
Users need:
- Python 3.11+ available as
python3.- A reachable local or self-hosted AI-Q Blueprint backend.
AIQ_SERVER_URLset when the backend is not running athttp://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. Thi...
Files:
skills/aiq-research/SKILL.md
🧠 Learnings (1)
📓 Common learnings
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Use this skill when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Use the skill to get a local or self-hosted NVIDIA AI-Q Blueprint server running and verified for `aiq-research`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: The skill owns setup, deployment, operational checks, troubleshooting, and shutdown; it does not run deep research itself.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: If no AI-Q checkout exists, read `references/locate-or-clone.md` before cloning.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: In an existing checkout, confirm the required repository files exist before proceeding (`pyproject.toml`, `deploy/.env.example`, and `configs/`).
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Before writing secrets, verify that `deploy/.env` is ignored; if it is not ignored, stop and fix the ignore rule first.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: When preparing environment secrets, create `deploy/.env` from `deploy/.env.example` only if it is missing, and never overwrite an existing `deploy/.env`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Never print secret values; only check whether required environment variables are set.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Do not ask the deployment mode question when the user already specified a mode, or when `aiq-research` routed here and a backend is needed.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: After startup, run the appropriate validation checks for the selected mode, and for the default local backend verify `http://localhost:8000/health`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: If the backend runs on a non-default port, set `AIQ_SERVER_URL` to the correct `http://localhost:<PORT>` value for `aiq-research`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Do not continue into deep research or deep research completion validation unless the user asks for it or confirms the post-deploy validation prompt.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Follow the version-compatibility rule: major versions must match, the Blueprint minor version must be greater than or equal to the skill minor version, and patch versions may differ.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Do not claim FRAG is ready unless both `RAG_SERVER_URL` and `RAG_INGEST_URL` are configured and reachable.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:52.019Z
Learning: Ask before destructive cleanup such as deleting Docker volumes with `down -v`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Use this skill only for research-shaped requests that should be routed through a reachable NVIDIA AI-Q Blueprint backend via `scripts/aiq.py`; do not use it for install, deploy, start, stop, UI, CLI, Docker, Helm, or troubleshooting requests, which belong to `aiq-deploy`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Before sending any user query, resolve the backend URL, run `health`, and if no backend is reachable ask for a backend URL or hand off to `aiq-deploy`.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Before sending a request, state the exact AI-Q backend URL that will receive it, and only proceed with non-local URLs after the user explicitly confirms the endpoint is trusted.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Do not send credentials, cookies, bearer tokens, API keys, or other secret values in query text or backend URLs.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: If AI-Q returns `deep_research_running`, poll the job with `research_poll` until completion; do not force polling when there is no job ID.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: If polling is interrupted, resume with `status`, `report`, or `research_poll` as appropriate; treat the job as continuing server-side.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: When a job completes successfully, present the full report with citations and source URLs intact.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: If a job fails, fails compatibly, or is cancelled, show the returned error and do not retry automatically.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: After presenting a report, support follow-up questions from the existing report or run a refined research pass using the same backend flow.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Use `AIQ_SERVER_URL` when set; otherwise default to `http://localhost:8000` for the local backend.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Require Python 3.11+ and a reachable AI-Q backend; the public helper has no third-party Python dependencies.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: If the backend returns `401` or `403`, stop and explain that this public skill does not manage authentication.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: If `health` succeeds but chat or async job routes fail, report the backend as reachable but incompatible with the public research flow and offer `aiq-deploy` validation.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: Do not truncate citations or source URLs from returned reports.
Learnt from: CR
Repo: NVIDIA-AI-Blueprints/aiq
Timestamp: 2026-06-29T18:48:58.902Z
Learning: For compatibility, the AI-Q Blueprint major version must match the skill version and the Blueprint minor version must be equal or greater.
🔇 Additional comments (2)
skills/aiq-deploy/SKILL.md (1)
352-353: LGTM!skills/aiq-research/SKILL.md (1)
410-411: LGTM!
Walkthrough
Two HTML comments with nvskills source-touch directives were added to skills/aiq-deploy/SKILL.md and skills/aiq-research/SKILL.md to trigger NVSkills validation refreshes. No user-facing content changed.
Changes
NVSkills Validation Touch
| Layer / File(s) | Summary |
|---|---|
No-op validation trigger comments skills/aiq-deploy/SKILL.md, skills/aiq-research/SKILL.md |
Adds HTML comments with nvskills source-touch directives at the noted line ranges; no instruction text or logic changes. |
Estimated code review effort
🎯 1 (Trivial) | ⏱️ ~2 minutes
Possibly related PRs
- NVIDIA-AI-Blueprints/aiq#277: Modifies
skills/aiq-research/SKILL.mdby adding new Step 6 follow-up/ask-redo instructions, touching the same file modified in this PR.
🚥 Pre-merge checks | ✅ 4 | ❌ 1
❌ Failed checks (1 warning)
| Check name | Status | Explanation | Resolution |
|---|---|---|---|
| Description check | The description omits the required template sections for Overview, Validation, reviewer start, and Related Issues. | Add the template headings and fill in Overview, Validation checks, reviewer entry point, and any related issue references. |
✅ Passed checks (4 passed)
| Check name | Status | Explanation |
|---|---|---|
| Title check | ✅ Passed | The title follows Conventional Commits and accurately describes a chore no-op CI trigger. |
| Docstring Coverage | ✅ Passed | No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. |
| Linked Issues check | ✅ Passed | Check skipped because no linked issues were found for this pull request. |
| Out of Scope Changes check | ✅ Passed | Check skipped because no linked issues were found for this pull request. |
✨ Finishing Touches
🧪 Generate unit tests (beta)
- Create PR with unit tests
Comment @coderabbitai help to get the list of available commands.
AjayThorve
force-pushed
the
ajay/nvskills-ci-trigger
branch
from
June 22, 2026 23:53
7550486 to
7d996b9
Compare
Member
Author
|
/nvskills-ci |
tanleach
force-pushed
the
ajay/nvskills-ci-trigger
branch
from
June 24, 2026 16:32
7d996b9 to
a5247f5
Compare
Collaborator
|
/nvskills-ci |
tanleach
marked this pull request as draft
June 24, 2026 17:10
AjayThorve
force-pushed
the
ajay/nvskills-ci-trigger
branch
from
June 29, 2026 05:41
a5247f5 to
ee5741a
Compare
…eploy Add a marker comment to each consumer skill's SKILL.md so the PR carries a source-level diff under skills/, which NVSkills CI requires to re-run validation. A BENCHMARK.md-only change is skipped because BENCHMARK.md is regenerated by NVSkills-Eval, not a skill source. No skill behavior, evals, signed artifacts, or maintainer skills under .agents/skills/ are affected. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Signed-off-by: Ajay Thorve <athorve@nvidia.com>
AjayThorve
force-pushed
the
ajay/nvskills-ci-trigger
branch
from
June 29, 2026 18:47
ee5741a to
581f695
Compare
|
Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually. Contributors can view more details about this message here. |
AjayThorve
marked this pull request as ready for review
June 29, 2026 18:48
Member
Author
|
/nvskills-ci |
Member
Author
|
Superseded by #293, which uses an origin-owned branch and contains only the required aiq-research SPDX compliance fix. |
AjayThorve
added a commit
that referenced
this pull request
Jun 29, 2026
## Overview - Add the required NVIDIA SPDX copyright declaration to `skills/aiq-research/scripts/aiq.py`. - Change the license identifier to `CC-BY-4.0 AND Apache-2.0` for OSS license compliance. - Keep this replacement focused: it contains no NVSkills trigger-marker or other no-op content changes. ## Why The SPDX-header CI check and OSRB review surfaced a license-compliance gap in the `aiq-research` skill. The skill also requires a fresh NVSkills signature after its content changed, so this fix is bundled with the re-sign request. ## Validation - `ruff check skills/aiq-research/scripts/aiq.py` - `pre-commit run --files skills/aiq-research/scripts/aiq.py` - `git diff --check` ## Where should reviewers start? `skills/aiq-research/scripts/aiq.py`: the two SPDX lines immediately after the shebang. ## Related issues Supersedes #279. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Chores** * Updated project metadata and copyright information. * Adjusted whitespace validation rules to skip a specific markdown pattern, reducing unnecessary formatting check failures. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Signed-off-by: Ajay Thorve <athorve@nvidia.com> Signed-off-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com> Co-authored-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No-op PR to trigger an NVSkills validation run on the consumer skills (
aiq-research,aiq-deploy).Appends a benign HTML comment to each skill's
BENCHMARK.mdso the PR carries a diff underskills/, which theNVIDIA/skillsteam-request workflow requires before dispatching the run. No skill behavior, signed artifacts (skill.oms.sig), or maintainer skills under.agents/skills/are affected.Summary by CodeRabbit