kkkhushman/x-algo-skill

This is a knowledge skill, a packaged reference document that AI coding agents can install to gain deep, accurate understanding of X's open-sourced For You feed algorithm, released in May 2026 from the xai-org/x-algorithm repository. A "skill" in this context is a collection of structured reference files that an AI agent loads into its context so it can reason correctly about a topic. Instead of an agent guessing how X's feed works based on potentially outdated training data, it loads this skill and gets citation-grounded information tied to specific files and lines in the upstream source code. Once installed, an agent can explain how X ranks posts in the For You feed, help design or audit a recommendation system based on X's architectural choices, answer questions about specific components (Phoenix model, Thunder, Grox, home-mixer, the candidate pipeline, and ads blending), and flag the 22 documented ways agents typically reason incorrectly about the algorithm. The skill is installed via the skills.sh command-line tool using a single command, and it works across more than 50 AI coding tools including Claude Code, Cursor, Codex, Copilot, Gemini CLI, and others. The format follows the Agent Skills specification, a SKILL.md entrypoint with YAML metadata, plus supporting markdown files organized by topic: architecture overview, the Phoenix ranking model, request lifecycle, ranking weights, content filtering, common pitfalls, and a glossary of internal terminology. The skill was built against the May 15, 2026 release of xai-org/x-algorithm and is licensed under Apache-2.0, matching the upstream source.