CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-ml

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

Quality

60%

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

Quality

Content

50%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 workflow is well-organized as a phase-by-phase directory of skills with clear sequencing, but it operates at a consistently high altitude: actions are generic, checklists lack verification procedures, and the prompts duplicate the skill listings. There is no progressive disclosure at all — everything lives in one inline file. Two skill annotations also appear mislabeled ('manifest - Manifest telemetry' under observability and 'prompt-engineering - Prompt security' under security), and Phase 7 is the only phase without copy-paste prompts.

Suggestions

Cut the 'Copy-Paste Prompts' blocks (or fold them into the skill lists) since each prompt merely restates the skill above it, and add a verification step to the checklists and Quality Gates so they function as checkpoints rather than bare boxes.

Make per-phase actions concrete — specify what 'Configure retrieval' or 'Implement evaluation' actually entails, or link each phase to a one-level-deep reference file (e.g. references/phase-3-rag.md) to enable progressive disclosure and shrink SKILL.md.

Fix the mislabeled skills ('manifest - Manifest telemetry' is not an observability tool; 'prompt-engineering' is not a security skill) and add the missing copy-paste prompts to Phase 7 for consistency.

DimensionReasoningScore

Conciseness

The body is list-based with no concept padding, which is efficient, but the 'Copy-Paste Prompts' blocks largely duplicate the 'Skills to Invoke' lists (e.g. 'Use @ai-product to design AI-powered features' restates the ai-product entry), and the action lists repeat generic steps across phases. This matches 'mostly efficient but includes some unnecessary content that could be tightened' rather than anchor 4's 'minor instances'.

3 / 5

Actionability

The copy-paste prompts are concrete, executable invocations ('Use @rag-engineer to design RAG pipeline'), but the per-phase 'Actions' are high-level directions ('Define AI use cases', 'Plan data flows', 'Configure retrieval') with no specifics on how to execute them — 'some concrete guidance but incomplete' rather than 'mostly executable with minor gaps'.

3 / 5

Workflow Clarity

Phases 1-7 are clearly sequenced and checklists plus 'Quality Gates' exist, but the checklists are bare unchecked boxes with no verification procedure, and there is no validate-fix-retry feedback loop; the 'Selection and completion' section only implicitly gestures at verification ('Verify each used capability in the target environment'). Checkpoints are present but implicit, matching anchor 3 rather than 4.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so the entire ~250-line directory — per-phase skill listings, actions, prompts, and checklists — is inlined in SKILL.md. Section headers provide some structure and nothing is buried or nested, but content that could be split into one-level-deep references is all inline, matching anchor 3.

3 / 5

Total

12

/

20

Passed

Description

53%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 communicates scope reasonably well through natural domain keywords, but reads as a topic list rather than a capability statement and lacks any 'when to use' trigger guidance. Its breadth over a domain crowded with sibling skills creates significant overlap risk.

Suggestions

Add an explicit trigger clause, e.g. 'Use when building LLM-powered applications, implementing RAG systems, creating AI agents, or developing ML pipelines' — this also lifts the completeness cap.

Replace generic verbs ('development', 'implementation', 'features') with concrete actions such as 'design agent architectures, set up vector-database retrieval, and build model training pipelines'.

Narrow the claimed scope or add distinguishing qualifiers so the description does not collide with individual AI/ML skills like rag-engineer or ml-engineer.

DimensionReasoningScore

Specificity

The description names the domain and several sub-areas ('LLM application development, RAG implementation, agent architecture, ML pipelines'), but these are topical categories with generic verbs rather than the concrete, specific actions of anchor 4 — 'development' and 'implementation' say nothing about what is actually done.

3 / 5

Completeness

There is a clear 'what' ('AI and machine learning workflow covering...'), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, so completeness is capped at 3 per the judging guidelines. It is above anchor 2 because the 'what' is clear and multi-part, not vague.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('AI and machine learning', 'LLM application', 'RAG', 'agent architecture', 'ML pipelines') that users would plausibly say. Not anchor 5 because common variations and synonyms are missing (e.g. chatbot, GenAI, retrieval-augmented generation, fine-tuning, model training).

4 / 5

Distinctiveness Conflict Risk

The description is very broad across the entire AI/ML domain and would overlap heavily with the many individual skills the bundle itself invokes (rag-engineer, ml-engineer, autonomous-agents, etc.). It is above anchor 1 only because the enumerated sub-areas give it some identity beyond pure genericity.

2 / 5

Total

12

/

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

sickn33/agentic-awesome-skills

Path

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