CtrlK
BlogDocsLog inGet started
Tessl Logo

recommendation-system

Deploy production recommendation systems with feature stores, caching, A/B testing. Use for personalization APIs, low latency serving, or encountering cache invalidation, experiment tracking, quality monitoring issues.

68

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable body with concrete, runnable code and well-signaled reference files, but it is verbose and self-duplicating, lacks explicit validation/feedback checkpoints in its workflows, and inlines substantial content that already lives in the reference bundle.

Suggestions

Deduplicate the body: keep one canonical /recommendations endpoint and Prometheus monitoring example (remove the repeats across Quick Start, Known Issues #1/#5, and Common Patterns) and link to references/ for the rest.

Add explicit validation checkpoints and a validate→fix→retry loop to the Quick Start and RecommendationService workflow (e.g., verify Redis is up, hit /health, re-validate after cache invalidation) since these involve production/deploy operations.

Trim the inline caching, A/B testing, monitoring, and feature-store sections to overviews that point to caching-strategies.md, ab-testing-framework.md, monitoring-alerting.md, and production-architecture.md instead of reproducing their implementations.

DimensionReasoningScore

Conciseness

The ~440-line body is mostly actionable code without patronizing concept explanations, but it repeats itself — the /recommendations endpoint and Prometheus monitoring code appear in Quick Start, Known Issues #1/#5, and Common Patterns, and inline caching/A-B/monitoring sections duplicate the dedicated reference files. It fits the score-2 anchor ('Mostly efficient but includes some unnecessary ... could be tightened') rather than the score-3 'every token earns its place'.

2 / 3

Actionability

Provides copy-paste-ready, executable guidance: pinned pip installs, a docker run command, a curl test, and complete Python for sample-size calculation, diversity ranking, and deterministic variant assignment. It matches the score-3 anchor ('Fully executable code/commands; specific examples; copy-paste ready'); a few domain stubs (fetch_from_db, model.predict) are reasonable abstractions rather than the pseudocode that defines score 2.

3 / 3

Workflow Clarity

The 5-step Quick Start and the numbered RecommendationService give a clear sequence, but there are no explicit validation checkpoints or validate→fix→retry feedback loops for production/caching/deploy operations. Per the scoring notes, missing validation in such workflows caps this at the score-2 anchor ('Steps listed but validation gaps; sequence present but checkpoints missing or implicit').

2 / 3

Progressive Disclosure

Four real reference files are clearly signaled one level deep in 'When to Load References' (a score-3 trait), but the body duplicates caching, A/B testing, monitoring, and feature-store implementations that each have a dedicated reference file, and the 'Known Issues Prevention' detail bloats the overview. This matches the score-2 anchor ('content that should be separate is inline') rather than the score-3 'content appropriately split'.

2 / 3

Total

9

/

12

Passed

Description

100%

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, third-person description that concisely states concrete capabilities and pairs them with an explicit 'Use for ...' trigger clause covering natural user terms. It answers both what the skill does and when to use it with low conflict risk.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Deploy production recommendation systems with feature stores, caching, A/B testing' — naming four distinct capabilities rather than vague abstractions. It matches the score-3 anchor ('Lists multiple specific concrete actions') and is well above the score-2 anchor which names only a domain and partial actions.

3 / 3

Completeness

Explicitly answers both 'what' ('Deploy production recommendation systems with feature stores, caching, A/B testing') and 'when' via an explicit 'Use for ...' trigger clause. This matches the score-3 anchor ('Clearly answers both what AND when with explicit triggers') and is not capped at 2 because the 'when' is explicit rather than implied.

3 / 3

Trigger Term Quality

The 'Use for personalization APIs, low latency serving, or encountering cache invalidation, experiment tracking, quality monitoring issues' clause covers several natural terms a user would say when needing this skill. It exceeds the score-2 anchor ('Some relevant keywords but missing common variations') by spanning multiple natural trigger phrases rather than a single generic one.

3 / 3

Distinctiveness Conflict Risk

'recommendation systems' with triggers like personalization APIs and experiment tracking carves a clear niche unlikely to fire for unrelated skills. It matches the score-3 anchor ('Clear niche with distinct triggers; unlikely to conflict') and is more specific than the score-2 'Works with document files' style overlap.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
secondsky/claude-skills
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.