CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-models

Research, compare, and update shared AI model JSON for TypeScript, web, and Rust consumers. Covers text model tiers, image and video generation models, image tool models, release provenance, pricing data sourcing, and product-side catalogue cost estimates. Use when bumping model versions, adding new models, updating pricing, or auditing model specs against provider documentation.

72

Quality

91%

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

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.

A high-quality, information-dense maintainer skill: every section carries repo-specific facts Claude could not know, commands are copy-paste ready, and the update workflow ends in an explicit validation checklist. The two weaker spots are mild rhetorical padding and a monolithic ~340-line body where per-domain detail could be split into reference files.

Suggestions

Trim editorial sentences that restate policy rhetorically (e.g. "keeping it is not caution", "a stale entry is a wrong answer, not a conservative one") — keep the rule, drop the persuasion.

Consider moving the long per-domain detail (video pricing key semantics, release-provenance source-priority list) into reference files under references/ and keeping one-line pointers in SKILL.md, mirroring the existing pointer to data/ai/PROVENANCE.md.

DimensionReasoningScore

Conciseness

The body is dense, repo-specific policy with almost no explanation of concepts Claude already knows (no library tutorials, no generic background), but a handful of rhetorical sentences could be trimmed — e.g. "a stale entry is a wrong answer, not a conservative one" and "keeping it is not caution". This is efficient-with-minor-trimmings (anchor 4) rather than lean-every-token-earns-its-place (anchor 5), and well above the some-unnecessary-explanation level (anchor 3).

4 / 5

Actionability

Fully executable guidance throughout: copy-paste command sequence ("node packages/grida-ai-models/scripts/generate.mjs --bundle --check"), exact script invocations ("python .agents/skills/ai-models/scripts/model_info.py --image <model_id>"), a provider pricing URL table, concrete discriminated-union pricing shapes, and per-model field lists (id, label, release, context_window, cost). Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The multi-step update process is clearly sequenced (edit data/ai JSON → generate.mjs → build TS packages → generate.mjs --bundle → --bundle --check) with each pass explained, and the "After Any Update" section is an explicit validation checklist (tests pass, --bundle --check passes, grep for stale IDs, docs/page verification). Validation checkpoints with fix-and-re-run semantics ("Builds/typechecks reject stale source projections") are present, matching the top anchor.

5 / 5

Progressive Disclosure

Good structure: well-sectioned headers, the bundled script (scripts/model_info.py) is referenced with concrete usage, and external detail is pointed to one level deep ("[the shared data guide](../../../data/ai/README.md)", data/ai/PROVENANCE.md, docs/wg/platform/hosted-ai.md). However, ~340 lines of per-domain policy (video pricing semantics, release-provenance rules, provider binding patterns) are inlined in SKILL.md where some could live in reference files, which fits anchor 4 (minor organization gaps) rather than the cleanly split structure of anchor 5.

4 / 5

Total

18

/

20

Passed

Description

92%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 strong description: it states what the skill does in third person, covers the full catalogue domain, and gives an explicit "Use when..." trigger clause with natural phrases. The only gap is missing synonyms/artefact-level terms (catalogue, facts.json, legacy models) that would make triggering even more robust.

DimensionReasoningScore

Specificity

Names three concrete actions ("Research, compare, and update shared AI model JSON") and comprehensively enumerates the domains covered: "text model tiers, image and video generation models, image tool models, release provenance, pricing data sourcing, and product-side catalogue cost estimates" — every catalogue domain is covered, so this fits the comprehensive anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

It explicitly answers both questions: a clear "what" ("Research, compare, and update shared AI model JSON for TypeScript, web, and Rust consumers" plus the coverage list) and an explicit "when" with concrete triggers ("Use when bumping model versions, adding new models, updating pricing, or auditing model specs against provider documentation"). This matches the top anchor exactly; the 4 anchor requires a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

The "Use when" clause supplies natural maintainer phrases ("bumping model versions", "adding new models", "updating pricing", "auditing model specs against provider documentation"), but it lacks synonyms and concrete artefact names a user might mention (e.g. the model catalogue, facts.json, deprecated/legacy models), which keeps it below the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

"shared AI model JSON for TypeScript, web, and Rust consumers" plus the specific trigger set (bumping model versions, updating pricing) carves out a distinct repo-maintenance niche with minimal overlap risk against general AI/coding skills, matching the clear-niche anchor at 5 rather than the minor-overlap anchor at 4.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

gridaco/grida

Path

.agents/skills/ai-models/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.