CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aiq-deploy

Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An operationally strong skill body: executable commands with expected outputs, a clearly sequenced nine-step workflow with explicit validation checkpoints and error-recovery loops, and a clean one-level-deep reference bundle. The main cost is token efficiency — duplicated reference tables, a padded semver section, and thrice-repeated security rules inflate the context footprint without adding guidance.

Suggestions

Delete the trailing References table (or the Step 4 routing table) — they list the same 13 rows; keep the intent-keyed routing table, which is the more useful navigation device.

Compress the Version Compatibility section to the three-line compatibility rule plus one positive and one negative example, or move the worked examples into a reference file; Claude does not need five enumerated comparisons to apply 'same major, minor ≥ skill minor'.

State each security rule once (Security Best Practices) and have the workflow steps reference it tersely — 'Never print secret values' / 'do not overwrite deploy/.env' currently appear in three sections.

DimensionReasoningScore

Conciseness

The body is mostly operational, but there is measurable fat: the Step 4 routing table and the trailing References table repeat the same 13 reference rows almost verbatim; the Version Compatibility section spends ~30 lines on a semver rule plus five worked examples (2.1.0 vs 2.2.0, 2.1.5, 3.0.0, 2.0.0) that Claude could apply from the rule alone; and security rules ('never print secrets', 'do not overwrite .env') are stated three times across Prerequisites, Step 3, and Security Best Practices. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 'minor instances' of anchor 4.

3 / 5

Actionability

Nearly every section gives copy-paste-ready bash with expected output: the .env guard ('git check-ignore deploy/.env'), the conditional .env copy, 'curl -sf http://localhost:8000/health' with expected results, full Docker Compose example commands, and concrete diagnostics ('lsof -nP -iTCP:8000 -sTCP:LISTEN', 'docker exec aiq-postgres pg_isready -U aiq -d aiq_jobs'). The mode-selection script is given verbatim, including when not to ask it — the examples cover the common cases.

5 / 5

Workflow Clarity

A nine-step numbered workflow with a per-step heading, and validation is explicit with feedback loops: each command has expected output, failures route to references/troubleshooting.md with 'diagnose before claiming the backend is ready', the destructive operation ('docker compose down -v') is gated behind explicit user approval, and the port-conflict Common Issue closes the loop with a re-verify curl. This matches the anchor-5 shape (validate → fix → re-validate, only proceed when healthy).

5 / 5

Progressive Disclosure

The body is a genuine overview: detailed procedures are split across 13 one-level-deep reference files, all of which exist and are clearly signaled by a user-intent routing table ('Match the user request, then read the referenced file before acting'). It stops short of 5 because navigation is duplicated — the routing table and the References section list the same 13 rows — and the detailed Version Compatibility material (~30 lines of semver rules and worked examples) belongs in a reference file rather than the overview, fitting 'minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid trigger-style description with an explicit 'Use when' clause, a clearly named domain, and a lifecycle-complete verb set. Its main weakness is that 'what' is expressed only as generic verbs over 'infrastructure' — the concrete deliverables (env setup, service startup, health validation, URL handoff) live only in the body and compatibility frontmatter.

Suggestions

State the concrete 'what' alongside the triggers, e.g. 'Prepares deploy/.env, starts the selected runtime (Docker Compose, local process, or Helm), runs health checks, and hands off the verified AIQ_SERVER_URL to aiq-research.'

Add natural trigger synonyms users would actually say — 'set up', 'launch', 'shut down', 'restart', 'health check' — and mention the concrete runtime names (Docker Compose, Kubernetes/Helm) in the description itself.

Optionally note the boundary with sibling skills explicitly ('infrastructure only; does not run deep research — use aiq-research') to sharpen distinctiveness for routing.

DimensionReasoningScore

Specificity

The description lists six concrete actions ("install, deploy, run, validate, troubleshoot, or stop") applied to a named domain ("NVIDIA AI-Q Blueprint infrastructure"), which matches the 'several specific actions; minor gaps' anchor. It falls short of 5 because the actions are bare verbs over a generic object — it never states what the skill concretely does (prepare deploy/.env, start Compose services, run /health checks, hand off AIQ_SERVER_URL) and only names one runtime path in the separate compatibility block.

4 / 5

Completeness

Both halves are explicitly present: the verb list answers 'what' and "Use when asked to..." is an explicit 'when' clause, so this clears the anchor-4 bar ('when' explicit, one side could be more specific). It is not 5 because the 'what' is thin — the same six verbs serve double duty as triggers without stating the concrete outcome (a running, validated server handed off to aiq-research), and no trigger synonyms or extensions are given.

4 / 5

Trigger Term Quality

Natural user-facing terms are present ("install", "deploy", "run", "validate", "troubleshoot", "stop", "NVIDIA AI-Q Blueprint"), matching 'good keyword coverage; a few natural terms missing'. It is not 5 because common variations users would actually say — 'set up', 'launch', 'restart', 'shut down', 'health check', 'Docker', 'Kubernetes' — are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

"NVIDIA AI-Q Blueprint infrastructure" carves out a clear niche, and the verb set — including lifecycle bookends like "stop" and "troubleshoot" — scopes it explicitly away from sibling skills such as deep research/report generation. Minimal conflict risk.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/nvidia/skills/aiq-deploy/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.