CtrlK
BlogDocsLog inGet started
Tessl Logo

gap-analysis

Audit TanStack AI provider adapters for feature parity gaps and outdated model lists. Triggered as /gap-analysis <provider|feature <name>|models|--all>. Produces a dated markdown report under .agent/gap-analysis/. Maintainer tool — does not edit feature-support.ts or model-meta.ts directly.

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

Passed

No findings from the security scan

The canonical home for this skill is gap-analysis in TanStack/ai

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 exemplary instruction-only skill body: concrete paths and commands throughout, a clearly sequenced workflow with explicit verification gates, and well-signaled one-level-deep references. The only room for improvement is trimming or relocating the inlined provider/feature/activity reference detail.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no concept explanations, just file paths, scope tables, and rules. Not 5 because the "Known providers" paragraph (bedrock's three-API surface, byteplus's dual keys) and the snapshot feature/activity lists are reference-grade detail inlined in SKILL.md that could be trimmed or moved; not 3 because there are no padded or redundant sections.

4 / 5

Actionability

Guidance is fully executable: exact truth-file paths ("testing/e2e/src/lib/feature-support.ts", "packages/ai-<provider>/src/model-meta.ts"), exact report naming (".agent/gap-analysis/YYYY-MM-DD-<scope>.md"), named MCP tools, a filename-to-activity-kind mapping table, and a concrete "git status" check. Nothing is left as vague direction.

5 / 5

Workflow Clarity

A clear 7-step numbered sequence with scope resolution first, an explicit fan-out policy ("max 3 in parallel", and when not to fan out), and a "Verification before finishing" checklist that validates the report exists, that nothing under packages/ or testing/ was modified, and that every real gap cites a URL. Explicit validation checkpoints with a feedback gate — the skill even guards its own read-only constraint.

5 / 5

Progressive Disclosure

Three reference files (audit-checklist.md, provider-doc-urls.md, report-template.md), each one level deep, linked at the point of use in the workflow, and all verified to exist. Not 5 because the known-providers detail, feature snapshot, and activities table are inlined rather than split into a reference, leaving minor organization gaps.

4 / 5

Total

18

/

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 highly specific, well-bounded description with concrete actions and strong distinctiveness. Its one weakness is the missing "Use when..." trigger guidance — it documents the invocation syntax but never states the situations in which the skill should be used, capping completeness.

Suggestions

Add an explicit trigger clause, e.g. "Use when auditing provider adapter coverage, checking for parity gaps, or verifying model lists are current".

Include a few natural trigger synonyms ("missing features", "model coverage", "adapter parity") so users phrasing the need differently still match.

Optionally mention the other audit dimensions (telemetry/observability parity, activity coverage) so the "what" is comprehensive.

DimensionReasoningScore

Specificity

"Audit TanStack AI provider adapters for feature parity gaps and outdated model lists", "Produces a dated markdown report under .agent/gap-analysis/", and "does not edit feature-support.ts or model-meta.ts directly" list several concrete actions with an explicit boundary. Not 5 because coverage has minor gaps (telemetry parity and activity-coverage dimensions are unmentioned); not 3 because it goes well beyond 1-2 actions.

4 / 5

Completeness

The "what" is clear and concrete (audit adapters for parity gaps and stale model lists, emit a dated report), but there is no "Use when..." clause or equivalent explicit trigger guidance — "Triggered as /gap-analysis <args>" describes how it is invoked, not when to reach for it, so completeness is capped at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

"feature parity gaps", "outdated model lists", "provider adapters", and "audit" are natural terms a TanStack AI maintainer would use. Not 5: the trigger is conveyed as invocation syntax ("Triggered as /gap-analysis ...") rather than usage scenarios, and synonyms like "missing features" or "model coverage" are absent.

4 / 5

Distinctiveness Conflict Risk

"TanStack AI provider adapters", "feature-support.ts", and "model-meta.ts" pin the skill to a narrow niche with distinct triggers; minimal conflict risk with any generic skill.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
TanStack/ai
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.