CtrlK
BlogDocsLog inGet started
Tessl Logo

aiq-research

Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.

63

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/nvidia/skills/aiq-research/SKILL.md
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.

A highly actionable, well-sequenced operational skill: every command is executable and verified against the bundle script, and each failure path has an explicit recovery step. The main cost is length — the troubleshooting and SemVer sections duplicate the instructions and could be trimmed or split into a reference file.

Suggestions

Consolidate 'Common Issues' with the Step 1 / Version Compatibility guidance it duplicates, or move it to a references/troubleshooting.md file and leave a two-line pointer — this alone would cut ~90 lines.

Replace the five SemVer worked examples with the three-line rule plus one compatible and one incompatible example.

Trim the 'Examples' section, since Example 1 and 2 restate the exact commands and expected outputs already given in Steps 2-4.

DimensionReasoningScore

Conciseness

The body is 356 lines with real padding: the ~90-line 'Common Issues' section re-covers failure cases already handled in Step 1 ('If a reachable backend returns 401 or 403, stop...') and the Version Compatibility section, and the SemVer rules are illustrated with five redundant worked examples ('Skill version 2.1.0 is compatible with Blueprint version 2.1.0 / 2.2.0 / 2.1.5...'). Most sections are efficient and AI-Q-specific, so it sits between 'mostly efficient' (3) and 'several padded sections' (2) — closer to 3 because the padding is concentrated rather than pervasive.

3 / 5

Actionability

Every step gives an exact, executable command ('python3 $SKILL_DIR/scripts/aiq.py chat "<USER_QUESTION>"', 'research_poll <JOB_ID>', 'status <JOB_ID>'), all of which exist in scripts/aiq.py, with expected output shapes stated ('{"status": "deep_research_running", "job_id": "<JOB_ID>"}'). This matches the anchor for fully executable, copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

The five steps are clearly sequenced (resolve backend → health check → send request → poll → present), with explicit validation checkpoints ('Run health before sending research requests', 'Stop on failed jobs and do not retry automatically') and feedback loops for every failure mode: unreachable backend, 401/403, incompatible version, and interrupted polling ('If has_report: true or job_status.status: success, fetch the report'). This matches the anchor for clear sequence with explicit validation and error-recovery loops; no destructive or batch operations apply.

5 / 5

Progressive Disclosure

Structure is good: the 'Available Scripts' table clearly signals the single bundle file and its arguments, the References table points one level deep to 'scripts/aiq.py' and '../aiq-deploy/SKILL.md' (both real, verified), and navigation is easy. It falls short of 5 because the ~90-line Common Issues and Version Compatibility sections are inlined in a 356-line SKILL.md where they could live in a references/ file, a 'minor organization gap' rather than the misplacement of the anchor-3 example.

4 / 5

Total

17

/

20

Passed

Description

70%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 concise, well-targeted description with an explicit 'Use when' trigger clause and a precise domain qualifier that limits conflict risk. Its main gaps are that it names only one action and omits the natural phrasings ('ask AI-Q about...') that the body itself identifies as triggers.

Suggestions

Add one or two of the skill's concrete capabilities to the description, e.g. 'Submits research queries to a local AI-Q Blueprint server, polls async deep-research jobs, and returns the final cited report.'

Include the natural trigger variations already listed in the body — 'use AI-Q to answer...' / 'ask AI-Q about...' — so users phrasing the request that way match the description too.

DimensionReasoningScore

Specificity

The description names the domain precisely ('a reachable NVIDIA AI-Q Blueprint backend') and one action ('run deep research or AI-Q research'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is above a 2 ('Processes PDF files'-level domain naming with no action) but below a 4 because it omits the concrete behaviors the body provides — submitting queries, polling async jobs, resuming interrupted jobs, presenting cited reports.

3 / 5

Completeness

Both parts are present and explicit: 'Use when asked to run...' clearly answers when, and 'run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend' answers what at a trigger level. It matches the anchor 'Has both what and when; when could be more explicit or specific' — here the what is the weaker half, since it says what to run rather than what the skill does (call the local helper script), keeping it below the 5 anchor's fully concrete pairing.

4 / 5

Trigger Term Quality

'deep research' and 'AI-Q research' are exactly the natural phrases users would say ('Use when asked to run deep research or AI-Q research...'), giving good keyword coverage. It falls short of the 5 anchor because natural variations the body itself lists — 'use AI-Q to answer...', 'ask AI-Q about...', 'research ...' — are absent from the description.

4 / 5

Distinctiveness Conflict Risk

The qualifier 'through a reachable NVIDIA AI-Q Blueprint backend' carves out a clear niche and distinguishes it from generic research skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. The residual risk is that a plain 'deep research on X' request with no AI-Q context could match this skill instead of a general deep-research skill — minor, not the anchor-3 'could still overlap with similar skills' level.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
openai/plugins
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.