CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tracking-model-versions

Build this skill enables AI assistant to track and manage ai/ml model versions using the model-versioning-tracker plugin. it should be used when the user asks to manage model versions, track model lineage, log model performance, or implement version control f... Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

Quality

74%

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 ./plugins/ai-ml/model-versioning-tracker/skills/tracking-model-versions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 a well-structured, mostly executable MLflow workflow with concrete API calls, a useful error-handling table, and appropriate one-level-deep references to real asset files. Its main weaknesses are the absence of validation checkpoints before production stage transitions and archiving (a destructive/batch cap on workflow clarity), and bundle hygiene issues: an unreferenced script, a scripts README listing nonexistent files, and a Resources link for Weights & Biases that is empty.

Suggestions

Add an explicit validation checkpoint before the destructive/production-affecting steps: e.g. between steps 5 and 6, "Before transitioning to Production or archiving the previous production version, verify the new version's metrics beat the current baseline via mlflow.search_runs(); only then transition, and keep the prior version archived-but-recoverable" — this lifts the workflow-clarity cap.

Fix the empty Resources link ("Weights & Biases Model Registry:" with no URL) and reconcile the Overview's claim of MLflow/DVC/Weights & Biases support with instructions that are MLflow-only, either adding brief per-tool notes or scoping the Overview to MLflow.

Clean up bundle navigation: reference scripts/version_control.py from the body if it is part of the workflow (or remove it), and correct scripts/README.md, which lists model_registry_client.py, performance_logger.py, and version_control.sh — none of which exist in the bundle.

DimensionReasoningScore

Conciseness

The body is efficient and does not explain concepts Claude already knows — steps are terse and command-driven ("start an MLflow run, log parameters (learning rate, epochs, batch size), log metrics (accuracy, loss, F1 score)"). Not a 5 because of minor redundancy: the Overview restates the Instructions/Output content, and step 7's enumeration of model-card sections ("training data description, evaluation metrics, intended use, limitations, and ethical considerations") duplicates what already lives in assets/model_card_template.md.

4 / 5

Actionability

Concrete, mostly executable guidance throughout: `mlflow experiments list`, `mlflow experiments create --experiment-name <name>`, `mlflow.<flavor>.log_model()`, `mlflow.register_model()`, `client.transition_model_version_stage()`, `mlflow.search_runs()`, plus a runnable server command in the error table. Not a 5 because there is no copy-paste-ready snippet and `client` is never constructed or imported, leaving a minor gap between the API calls and working code.

4 / 5

Workflow Clarity

The 8 steps form a clear connect → experiment → log → register → transition → compare → model-card → alerts sequence with an initial connectivity checkpoint ("verify connectivity with `mlflow experiments list`") and an Error Handling table for recovery. However, the workflow performs production-affecting registry operations — "Transition the model version through stages: None -> Staging -> Production" and "Archive previous production versions" — with no validation step before promoting or archiving (only an Example shows a compare-before-promote gate), so the destructive/batch validation cap applies at 3.

3 / 5

Progressive Disclosure

Scored against the actual bundle: the body is a well-organized overview with two clearly signaled, one-level-deep references that exist ([assets/model_card_template.md](assets/model_card_template.md), [assets/example_mlflow_workflow.yaml](assets/example_mlflow_workflow.yaml)). Not a 5 because scripts/version_control.py is never referenced from SKILL.md (orphan file), scripts/README.md lists three scripts (model_registry_client.py, performance_logger.py, version_control.sh) that do not exist in the bundle, and references/ contains only a stub README with no content.

4 / 5

Total

15

/

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.

The description covers a genuinely distinct niche and includes an explicit use-when clause with several natural trigger phrases, but it is marred by a garbled opening ("Build this skill enables AI assistant to track and manage"), a truncated phrase ("implement version control f..."), and pure template boilerplate ("Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.") that replaces what should be concrete trigger guidance. It also references a "model-versioning-tracking plugin" that the body never mentions, creating a mismatch with the MLflow/DVC/W&B tooling actually described.

Suggestions

Rewrite the opening in clean third person and state concrete operations, e.g. "Logs, compares, and manages AI/ML model versions in an MLflow model registry: register models, transition Staging/Production stages, log metrics, and generate model cards" — this raises specificity by replacing generic track/manage verbs with concrete actions.

Delete the template boilerplate ("Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.") and complete the truncated phrase, replacing them with specific triggers such as "Use when the user mentions MLflow, model registry, model versioning, tracking model lineage, or promoting a model to production."

Align the description's tooling mention with the skill body: either name MLflow/DVC/Weights & Biases explicitly (adding natural trigger keywords users would say) or drop the fictitious "model-versioning-tracking plugin" reference.

DimensionReasoningScore

Specificity

The description names the domain ("ai/ml model versions") and a handful of actions ("track and manage ai/ml model versions", "track model lineage", "log model performance"), but the verbs stay generic, the opening is garbled ("Build this skill enables AI assistant to track and manage"), and no concrete operations like registering models, transitioning stages, or generating model cards are stated. It falls between anchor 3 (1-2 concrete actions) and anchor 4 (several specific actions) because the several actions named are all phrased at an abstract track/manage/log level.

3 / 5

Completeness

Both what ("track and manage ai/ml model versions... log model performance") and an explicit when ("it should be used when the user asks to manage model versions, track model lineage, log model performance, or implement version control") are present. Not a 5 because the when clause is truncated mid-phrase ("implement version control f...") and diluted by template boilerplate ("Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.") that adds no real trigger guidance; not a 3 because an explicit use-when clause does exist.

4 / 5

Trigger Term Quality

Natural user phrases are present ("manage model versions", "track model lineage", "log model performance") and map well to what a user would say, giving good keyword coverage. It is not a 5 because common variations and synonyms users would actually say are missing ("MLflow", "model registry", "model versioning", "compare model versions", "promote to production").

4 / 5

Distinctiveness Conflict Risk

The AI/ML model-versioning niche ("track and manage ai/ml model versions", "model lineage") is mostly distinct with minor overlap risk from closely related skills. It is not a 5 because the trigger phrase "implement version control f..." could fire on ordinary git/version-control requests, creating overlap with generic version-control skills.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/ai-ml/model-versioning-tracker/skills/tracking-model-versions/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.