Design recommendation and ranking workflows that select the best items for a user or situation. Organize candidate retrieval, enrichment, filtering, scoring, selection, and background recording into six stages, then generate a runnable code scaffold.
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.
Design recommendation and ranking workflows that choose the top candidates for a user or situation. The skill divides the workflow into six stages: candidate retrieval, enrichment with required information, filtering, scoring, selection, and recording deliveries or related events. It creates runnable code scaffolds in TypeScript, Go, or Python. Recording and counter updates run without holding up the response.
Use it for content recommendations, search result reranking, reassessing documents retrieved for RAG, or prioritizing tasks. It also helps organize the processing needed before and after an existing scoring model. Consider choices such as using one score or predictions of several actions, and computing results on request or in advance.
You must provide the scoring function. Model design, machine learning training, and monitoring or automatic scaling after deployment are outside the scope. The skill is an independent implementation under the MIT license. The referenced pattern comes from xAI’s publicly released For You algorithm.
This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.
AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.
The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 19, 2026. Treat it as a guide and read the original before installing.
Review the instructions the agent will receive before you install.
A spec-and-scaffold skill for building composable recommendation, ranking, and feed pipelines. It encodes the six-stage pattern — Source → Hydrator → Filter → Scorer → Selector → SideEffect — popularized by xAI's open-sourced For You algorithm (Apache 2.0). This skill is an independent reimplementation of the pattern (MIT) — no code copied from the original.
Upstream: https://github.com/mturac/recsys-pipeline-architect
| # | Stage | Job | Parallel? |
|---|---|---|---|
| 1 | Source | Fetch candidates from one or more origins | Yes — multiple sources run in parallel |
| 2 | Hydrator | Enrich each candidate with metadata needed for filtering and scoring | Yes — independent hydrators run in parallel |
| 3 | Filter | Drop candidates that should never be shown (blocked, expired, duplicate, ineligible) | Sequential — each filter sees fewer items |
| 4 | Scorer | Assign each surviving candidate one or more scores | Sequential — later scorers see earlier scores |
| 5 | Selector | Sort by final score, return top K | Single op |
| 6 | SideEffect | Cache served IDs, log impressions, emit events, update counters | Async — must never block the response |
Walk the user through these eight steps:
P(action) for many actions (read, like, share, skip, report), combine with weights at serving time. To change behavior → change weights. No retraining.The X For You system uses multi-action with both positive and negative weights. Recommend multi-action when the user expects to tune frequently.
Default to isolation. Joint only when there's a specific reason (e.g., explicit batch-aware diversity).
github.com/xai-org/x-algorithm (Apache 2.0).The upstream repository at https://github.com/mturac/recsys-pipeline-architect ships:
SKILL.md with the complete 8-step workflowInstall via skills.sh: npx skills add mturac/recsys-pipeline-architect
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Design and audit interfaces for Web, iOS, and Android using WCAG 2.2 accessibility guidance. Check screen-reader labels, keyboard navigation, contrast, and control sizes to identify barriers and guide implementation for people using assistive technology.
Investigate unreliable AI agents across 12 layers, including instructions, memory, tool execution, and display. Use code and logs to trace failures, rank findings by severity, and produce an ordered repair plan that prioritizes code changes.
Compare coding agents on tasks from your own codebase. Define success checks, run agents in separate Git working directories, and report pass rates, available API costs, completion time, and consistency across repeated trials.
Design and refine an AI agent’s available actions, tool inputs, and result formats. Define recovery steps for errors, manage the information kept in context, and evaluate changes through completion rates, retries, and cost per successful task.
Diagnose AI agent runs that fail repeatedly, loop through tools, or lose track of the task. Capture errors and environment details, test a focused recovery action, and produce a report explaining the evidence and outcome.
Diagnose failed AI agent runs by capturing errors, checking likely causes, and choosing small, reversible recovery actions. The workflow produces a structured report of the failure, recovery steps, and evidence, helping explain repeated retries or stalled progress.