CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ml-adoption-playbook

End-to-end methodology for AI agents and software engineers to add machine learning algorithms to existing non-ML codebases. Covers problem framing, data readiness, architectural decoupling, and baseline model integration. Use when adding a machine learning capability to a codebase that has none, from problem framing through a baseline model.

Quality

79%

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/ml-adoption-playbook/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well structured: a clean five-phase progression with an explicit agent-execution order and mostly lean prose. Its main weakness is actionability — directives name the right moves but rarely show them (no data-contract template, no evaluation command, no code), leaving the lowest dimension at 3.

Suggestions

Add concrete artifacts for the lowest dimension: an example data-contract schema (fields, types, missing-value policy) and a runnable baseline-evaluation command or script stub.

Make verification gates explicit in the workflow (e.g., 'Phase 2 exit: user has approved the data contract; Phase 4 exit: evaluation script beats baseline') with a fix-and-retry loop.

Move per-phase detail (e.g., leakage-prevention examples, fallback design patterns) into one-level-deep reference files so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

Mostly lean bullets with a few skippable framing sentences ("ML is useless without clean, accessible data.", "Do not tightly couple model inference to core business logic.") that restate what the bullets already instruct. Not 5 because of these minor padding instances; not 3 because there is no explanation of concepts Claude already knows and no library tutorials.

4 / 5

Actionability

Several directives are concrete ("fix random seeds, make code device-agnostic", "Wrap the new ML inference call in a feature flag", "Ask the user if a simple heuristic... could solve the problem"), but most bullets tell what to do without how — no example data contract, no evaluation-script command, no code. Not 4 because, as an instruction-only skill, the guidance lacks the specific executable details (templates, commands, examples) that would make it fully actionable; not 2 because the phase directives are specific and directive rather than vague.

3 / 5

Workflow Clarity

Five phases are clearly sequenced, and the "Iterative Agent Workflow" section adds explicit ordering constraints ("before proposing architectures", "before writing the training loop"). One validation checkpoint exists ("Do not accept a model without an evaluation script comparing it against the baseline"), but other checkpoints (user approval of the data contract, fallback verification) are implied rather than stated as verify-gates. Not 5 because feedback loops (validate → fix → re-verify) are not spelled out; not 3 because the sequence and at least one explicit checkpoint are present.

4 / 5

Progressive Disclosure

A self-contained single-file skill with well-organized, clearly headed sections and no external bundle files to manage. Not 5 because the body (~51 lines) slightly exceeds the under-50-line simple-skill threshold and the phase bullets are dense enough that detail (e.g., data-contract schema, evaluation criteria) could live in one-level-deep reference files; the named cross-references (`fastapi-patterns`, `pytorch-patterns`, `mle-workflow`) point to skills outside this bundle rather than signposted files.

4 / 5

Total

15

/

20

Passed

Description

83%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: third-person voice, concrete scope enumeration, and an explicit, well-scoped 'Use when' clause. Trigger terms are natural but miss a few common synonyms (e.g., "train a model", "AI feature") that would push trigger coverage and distinctiveness to the top anchor.

Suggestions

Add common user phrasings like "train a model", "add AI to the app", or "predictive feature" to broaden natural trigger coverage.

Sharpen the capability list toward actions (e.g., "frame the ML problem, audit data sources, decouple inference behind an API, deliver a baseline model") to match the top specificity anchor.

DimensionReasoningScore

Specificity

Enumerates four specific capability areas — "problem framing, data readiness, architectural decoupling, and baseline model integration" — which names the domain and several distinct coverage areas. Falls short of 5 because these are process phases rather than concrete operations (no extract/fill/merge-style action verbs), and above 3 because coverage spans multiple named stages of the task.

4 / 5

Completeness

Explicitly answers both: what ("End-to-end methodology... Covers problem framing, data readiness, architectural decoupling, and baseline model integration") and when ("Use when adding a machine learning capability to a codebase that has none, from problem framing through a baseline model"). The 'when' clause is concrete and clearly scoped; not below 5 since neither component is vague or implicit.

5 / 5

Trigger Term Quality

Natural trigger phrasing is present ("add machine learning algorithms", "ML", "baseline model", "codebase that has none"), matching how a user would phrase the request. Not 5 because common synonyms and variations like "train a model", "AI feature", "recommendation", or "predictive model" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche — introducing ML into an existing non-ML codebase, from framing through a baseline model — is clearly delimited and explicitly excludes ongoing MLOps. Not 5 because it overlaps at the edges with general ML-training and model-deployment skills; not 3 because the "codebase that has none" framing is a distinct trigger from those skills.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/ml-adoption-playbook/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.