CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recsys-pipeline-architect

Design composable recommendation, ranking, and feed pipelines using the six-stage Source→Hydrator→Filter→Scorer→Selector→SideEffect framework popularized by xAI's open-sourced For You algorithm. Use this skill whenever the user is building any system that picks "the top K items for a (user, context)" — social feeds, content CMSs, RAG rerankers, task prioritizers, notification triage, search reranking, ad ranking.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A well-structured, information-dense body: the six-stage framework table, the why-this-order rationale, eight-step workflow, explicit trade-offs, hard rules, and anti-patterns give Claude actionable architecture guidance with no filler concept explanations. The main gaps are promotional upstream/install content competing for tokens, no explicit scaffold-validation step in the workflow, and reference docs advertised but absent from the bundle.

Suggestions

Remove or shrink the 'Upstream contents' section and the 'Install via skills.sh' line — they are promotional metadata, not operational guidance, and consume tokens that a loaded skill does not need.

Add an explicit validation step to the workflow (e.g., step 9: run the generated scaffold's test suite and iterate until green) so the 'the generated scaffold must run' hard rule is enforced by a feedback loop rather than only stated.

Bundle the advertised reference docs (interfaces in 4 languages, filter cookbook, scorer cookbook) locally and link them in a dedicated 'References' section so the progressive-disclosure structure actually exists instead of being described as living only in the upstream repo.

DimensionReasoningScore

Conciseness

The body is dense and table-driven with essentially no explanation of concepts Claude already knows. However, the "Upstream contents" section, the "Upstream:" link line, and "Install via skills.sh: npx skills add …" are promotional, non-operational tokens that could be trimmed. Localized padding keeps it above 3 but short of the every-token-earns-its-place level of 5.

4 / 5

Actionability

Guidance is mostly concrete and executable: the eight-step workflow, a specific filter checklist, scorer chain composition, "Latency budget: 100–300ms", and "Wrap in fire-and-forget patterns (goroutines / promises without await / asyncio tasks)". As an instruction-only skill the absence of code is not penalized, but generating a runnable scaffold depends on interface details that live only in unbundled upstream reference docs — minor gaps that keep it below 5.

4 / 5

Workflow Clarity

The eight-step workflow is clearly sequenced and opens with an explicit clarification checkpoint ("one round, three questions"). It lacks an explicit validation step for the generated scaffold (e.g., run its test suite to confirm the "must run" hard rule), so it does not reach the 5 anchor's validate→fix→retry feedback loop; it sits above 3 because a sequence and checkpoints are present.

4 / 5

Progressive Disclosure

The single SKILL.md is well organized with clear headers, a stage summary table, and no nested references, and the body points to upstream materials at one level. It is not a 5: at ~110 lines it exceeds the simple-skill exception, inlines meta-content that belongs elsewhere, and the five load-on-demand reference docs it advertises are not present in the bundle, leaving no local progressive-disclosure structure.

4 / 5

Total

16

/

20

Passed

Description

91%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, concrete, with an explicit 'Use when…' clause and unusually broad, natural trigger-term coverage spanning seven application domains. The only weaknesses are a single-verb action statement and mild overlap risk from broad trigger terms like search reranking and RAG rerankers.

DimensionReasoningScore

Specificity

"Design composable recommendation, ranking, and feed pipelines using the six-stage Source→Hydrator→Filter→Scorer→Selector→SideEffect framework" names one concrete action with a highly specific named framework and enumerated pipeline types. It exceeds the 1-2-generic-actions level of a 3 but lacks the multiple distinct verbs of a 5 ("Extract text… fill forms, merge documents, convert pages to images").

4 / 5

Completeness

It explicitly answers both what ("Design composable recommendation, ranking, and feed pipelines using the six-stage … framework") and when ("Use this skill whenever the user is building any system that picks 'the top K items for a (user, context)' — social feeds, … ad ranking") with concrete trigger phrases, exactly matching the 5 anchor. A 4 would require a less explicit or less specific 'when' clause.

5 / 5

Trigger Term Quality

The description covers natural terms comprehensively: "recommendation, ranking, and feed pipelines", "social feeds, content CMSs, RAG rerankers, task prioritizers, notification triage, search reranking, ad ranking", plus the paraphrase "the top K items for a (user, context)". Coverage includes synonyms across the whole domain with few natural phrasings missing, matching the comprehensive-coverage anchor rather than the 'a few natural terms missing' level of 4.

5 / 5

Distinctiveness Conflict Risk

The recsys-pipeline niche is clear with distinct triggers, but broad application terms like "search reranking", "RAG rerankers", and "task prioritizers" create minor overlap risk with general ranking/RAG/prioritization skills. Mostly distinct with minor overlap, matching the 4 anchor rather than the minimal-conflict clarity of a 5.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/recsys-pipeline-architect/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.