CtrlK
BlogDocsLog inGet started
Tessl Logo

building-recommendation-systems

Execute this skill empowers AI assistant to construct recommendation systems using collaborative filtering, content-based filtering, or hybrid approaches. it analyzes user preferences, item features, and interaction data to generate personalized recommendations... Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

36

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

20%

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

The body reads as a generic template: organized into sections and sequenced, but containing no executable code, no validation checkpoints, and no links to the bundled scripts/configuration that actually exist. Actionability and conciseness are the weakest dimensions.

Suggestions

Add concrete, executable guidance — at minimum a runnable snippet invoking the bundled scripts (e.g. `python scripts/build_collaborative_filtering.py --config assets/configuration_template.yaml`) — instead of 'The skill will: Generate code...'.

Reference the real bundle files: point 'Best Practices' and 'Examples' to scripts/build_*.py and assets/configuration_template.yaml rather than the generic 'Resources: Project documentation' filler.

Add a validation feedback loop for the training/evaluation workflow (e.g. train -> evaluate with precision/recall/NDCG -> if below threshold, tune hyperparameters and retrain), since missing feedback loops cap workflow_clarity at 2.

Cut boilerplate sections ('Output: The skill produces structured output relevant to the task', 'Prerequisites: Required dependencies installed') that add no actionable information.

DimensionReasoningScore

Conciseness

The body is padded with generic boilerplate that tells Claude nothing new: "The skill produces structured output relevant to the task", "Review the generated output", "Apply modifications as needed", and "Resources: Project documentation, Related skills and commands". Not 2 because the inefficiency is pervasive boilerplate rather than minor tightening; 1 is the scale minimum.

1 / 3

Actionability

No executable code or commands appear anywhere; examples merely describe ("The skill will: 1. Generate code to load and preprocess movie rating data") and instructions are abstract ("Provide necessary context and parameters", "Review the generated output"). Not 2 because there is no pseudocode or partial concrete guidance — it is purely descriptive; for a code-generation skill the absence of any executable reference is penalized per the scoring notes.

1 / 3

Workflow Clarity

Sequences are present ("How It Works" lists Analyzing Requirements -> Generating Code -> Implementing Best Practices), but there are no validation checkpoints or validate-fix-retry feedback loops for model training/evaluation. Not 3 because there are no explicit validation steps; not 1 because steps are clearly sequenced rather than missing. Capped at 2 per the feedback-loops note for batch/training operations.

2 / 3

Progressive Disclosure

Sections are organized, but the body never links the actual bundle files (scripts/build_collaborative_filtering.py, assets/configuration_template.yaml, etc.) and "Resources" is generic filler rather than signaled one-level-deep references. Not 3 because there are no well-signaled references to the real bundle; not 1 because it is sectioned, not a monolithic wall or nested references.

2 / 3

Total

6

/

12

Passed

Description

50%

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 clearly states what the skill does and targets a distinct recommendation-systems niche, but its trigger guidance is generic placeholder boilerplate ("Use when appropriate context detected") rather than concrete natural triggers. All dimensions land at 2 as a result.

Suggestions

Replace the boilerplate trigger ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose') with concrete natural triggers, e.g. 'Use when the user asks to build a recommendation system, suggest products/movies/content, or implement collaborative or content-based filtering.'

Fix the broken opening phrasing ('Execute this skill empowers AI assistant to construct...') and write the description in clean third-person voice ('Builds recommendation systems...').

List more concrete actions (e.g. 'trains models, evaluates with precision/recall/NDCG, handles cold-start') to lift specificity toward a 3.

DimensionReasoningScore

Specificity

It names the domain and some actions ("construct recommendation systems using collaborative filtering, content-based filtering, or hybrid approaches" and "analyzes user preferences, item features, and interaction data to generate personalized recommendations"), but does not list multiple distinct concrete actions. Not 3 because there is no comprehensive list of concrete actions (cf. "extract text, fill forms, merge documents"); not 1 because it states concrete domain actions beyond "helps with documents".

2 / 3

Completeness

The "what" is clearly stated (builds recommendation systems that analyze data to generate recommendations), but the "when" is only boilerplate ("Use when appropriate context detected") rather than an explicit trigger, so it does not clearly answer when. Not 3 because there is no explicit real trigger guidance; not 1 because the "what" is solid and a Use-when clause is present, even if weak.

2 / 3

Trigger Term Quality

Domain keywords like "recommendation systems" and "recommendations" are terms a user would say, but the explicit trigger is generic boilerplate ("Use when appropriate context detected. Trigger with relevant phrases based on skill purpose") with no concrete natural trigger phrases. Not 3 because there is no good coverage of natural trigger phrases; not 1 because some relevant domain keywords are present rather than pure technical jargon.

2 / 3

Distinctiveness Conflict Risk

The recommendation-systems niche is fairly distinct ("collaborative filtering, content-based filtering, or hybrid approaches"), but the generic trigger boilerplate raises overlap risk with other ML/data skills. Not 3 because there are no distinct explicit triggers; not 1 because the domain niche is specific rather than "helps with code and documents".

2 / 3

Total

8

/

12

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.

Validation14 / 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/claude-code-plugins-plus-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.