CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-models

Latest AI models reference - Claude, OpenAI, Gemini, Eleven Labs, Replicate

56

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/ai-models/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

The body is highly actionable — copy-paste model IDs, executable snippets, and useful selection guidance — but it is a monolithic 675-line reference that should be split across bundle files, with duplicated task tables and boilerplate SDK examples adding avoidable tokens. Time-sensitive version data appears throughout without a deprecated-section guard.

Suggestions

Split each provider's model ID dictionary, usage snippets, and model-selection tree into references/<provider>.md files, keeping SKILL.md as a concise overview with the selection matrix and clearly signaled one-level-deep links.

Remove the duplicated task-to-model tables (keep either the top "Model Selection Matrix" or the bottom "Best For Each Task", not both) and drop the generic SDK client-setup boilerplate that Claude already knows.

Isolate the version-dated model IDs in a clearly dated "Current models (verified December 2025)" section with the Model Update Checklist adjacent, so stale entries are easy to spot and replace.

DimensionReasoningScore

Conciseness

The body is dense with genuinely useful data (model ID constants, pricing, context limits), but the task-to-model mapping is duplicated ("Model Selection Matrix" at top vs. "Best For Each Task" at bottom), and the per-provider SDK usage snippets ("import OpenAI from 'openai'; const openai = new OpenAI(...)") are boilerplate Claude already knows. Version-dated strings ("December 2025", 'claude-opus-4-5-20251101') are time-sensitive with no deprecated/old-patterns section, which the rubric penalizes. This is mostly efficient but could be tightened — not anchor 2 (no concept explanations or heavy padding) and not anchor 4 (the duplication and boilerplate are more than minor).

3 / 5

Actionability

Model IDs are given as copy-paste-ready constants ('claude-sonnet-4-5-20250929', 'gpt-4.1', 'black-forest-labs/flux-2-pro'), SDK snippets are complete and executable (client setup, chat, vision, embeddings, TTS), and each provider includes docs/pricing links plus an env-var template. Specific examples cover the common cases (chat, vision, embeddings, image generation, voice).

5 / 5

Workflow Clarity

As a single-purpose lookup skill, the primary action is unambiguous: the selection matrix and per-provider "Model Selection" trees map task to model, and the "Model Update Checklist" provides a maintenance sequence. It falls short of anchor 5 because there is no validation step for the time-sensitive data (e.g., verifying model IDs against the linked docs before use), leaving a minor checkpoint gap.

4 / 5

Progressive Disclosure

The bundle contains no references/, scripts/, or assets/ files — everything is inlined in SKILL.md. Section headers and a consistent per-provider layout give it real structure (above anchor 2's "minimal structure"), but hundreds of lines of per-provider API reference (usage snippets, model trees, model ID dictionaries) clearly belong in separate reference files, matching anchor 3's example of inline content that should be split.

3 / 5

Total

15

/

20

Passed

Description

61%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.

The description is concise and names a clear, distinctive niche with concrete provider triggers, but it states no specific actions and lacks an inline 'Use when...' clause (trigger guidance is relegated to a separate when-to-use field). It is serviceable but below the rubric's strong examples.

Suggestions

Fold the trigger guidance into the description itself, e.g., append ". Use when choosing models, comparing capabilities, or referencing model specs and pricing." so the description answers both what and when.

Replace the generic word "reference" with concrete actions such as "Look up current model IDs, context windows, and pricing across Claude, OpenAI, Gemini...".

Add natural trigger synonyms users would say — "LLM", "GPT", "model pricing", "model comparison" — to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Latest AI models reference" names the domain and enumerates five concrete providers ("Claude, OpenAI, Gemini, Eleven Labs, Replicate"), but "reference" is a generic action with no specific capabilities stated (e.g., looking up model IDs, comparing pricing, checking context limits). It sits above anchor 2 (which names only a domain) but below anchor 4 (which lists several specific actions).

3 / 5

Completeness

The description has a clear "what" ("Latest AI models reference") but no "Use when..." clause; the trigger guidance ("When choosing models, comparing capabilities, or referencing model specs") lives only in the separate when-to-use frontmatter field, not the description. Per the rubric, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

The provider names ("Claude, OpenAI, Gemini, Eleven Labs, Replicate") plus "AI models" and "model specs" are natural terms users would say. A few common variations are missing ("GPT", "LLM", "pricing", "model comparison"), keeping it below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The cross-provider model-reference niche with explicit provider names is mostly distinct, though it could overlap with provider-specific skills (e.g., a Claude API or OpenAPI-specific skill) triggered by the same provider names. Not anchor 5 because the provider terms alone are shared with narrower single-provider skills.

4 / 5

Total

14

/

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

skill_md_line_count

SKILL.md is long (684 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

alinaqi/maggy

Path

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.