x-algorithm

x-algorithm-skill

A Claude skill that teaches Claude to write X (Twitter) posts engineered against the open-source For-You ranker.

X open-sourced its For-You feed algorithm twice: the legacy stack in March 2023, and the new Grok-powered Phoenix transformer in May 2026. This skill reads both, the active Community Notes bridging algorithm, and 10+ public analyses — then distills everything into a workflow your Claude can run on every post you draft.

The result: posts engineered to survive the banger screen, score high on the Phoenix transformer, embed into the right SimClusters communities, and trigger the engagement velocity that opens out-of-network distribution.

---

What it does

When you ask Claude to write or review an X post, the skill:

1. Drafts against 29 named, enforceable policies derived from the algorithm code (e.g., P-15: "Reply hand-typed to every reply within first hour — reply_engaged_by_author is +75 weight, 150× a like").
2. Runs a 15-checkbox pre-flight scan before you post, citing the exact policy ID for any failure.
3. Cites the algorithm directly — every recommendation is anchored to a code path (home-mixer/scorers/ranking_scorer.rs) or a published weight (2023 release), with confidence markers (🟢 confirmed / 🟡 likely / 🟠 reasoned).

Examples:

• "Write me a launch post for [product]" → drafts → pre-flight scans → revises until every check passes → recommends timing + media plan.
• "Improve this tweet" → scores it against the algorithm → cites specific policy failures → proposes rewrites with magnitude estimates.
• "Should this be a thread?" → walks through the AuthorDiversityScorer math ((1−0.25) × 0.5^position + 0.25 — 5th tweet runs at ~30% of standalone score) and DedupConversationFilter behavior, defaults to "no" unless each tweet stands alone.

---

Quick demo

You: Write me an X post announcing a new open-source tool.

Claude (with x-algorithm-skill loaded):

Draft v1:
"Excited to announce our new open-source tool! It does X, Y, and Z. 🚀
Check it out: github.com/..."

[Pre-flight scan:]
  ✗ P-1 slop-vocab: "Excited to announce" is a high slop_score trigger
  ✗ P-2 stop-scroll: first 6 words = "Excited to announce our new open" — generic, doesn't stop scroll
  ✗ P-5 quotable: no self-contained quotable line
  ✗ P-6 reply-bait: no disagreeable position
  ✗ M-1 video: no media attached
  ✓ M-2 native screenshot: N/A (no media yet)
  ...

Draft v2 (rewritten — sounds like a person, not a press release):
"built [Tool] because every existing option made me [do the annoying thing]
and I finally snapped.

it does [specific thing] using [specific approach] instead of [the obvious
default] — which is the one decision that makes it [concrete benefit].
honestly didn't expect that to matter as much as it does.

works with [X], [Y] and [framework Z]. open source.

github.com/..."

[Pre-flight scan: all 17 pass — including the human-voice checks (16-17)]
[Timing recommendation: 14:00 UTC weekday]
[Media plan: 20s vertical screen recording showing the tool. Self-reply with
 architecture diagram screenshot 30-45 min after.]

Note the rewrite has no em-dash bullet list and no "three things" triplet — those are AI-writing tells that trip the banger classifier's slop_score. The skill's #1 rule (P-20) is to sound like a human, not like optimized copy. A robotic-but-"optimized" post loses.

---

Install

Claude Code plugin (recommended) — runs as a skill inside Claude Code

⚠️ Two steps. Both required. Don't skip step 1. Claude Code uses a marketplace-based plugin system; you must register this repo as a marketplace before you can install the plugin from it.

Step 1 — register this repo as a marketplace:

/plugin marketplace add ceoguy/x-algorithm-skill

Step 2 — install the plugin from the marketplace:

/plugin install x-algorithm@ceoguy-x-algorithm-skill

Then restart Claude Code so the new plugin loads. (Installing/updating a plugin requires a restart to apply — there is no live-reload command.)

Verifying the install worked:

/plugin marketplace list     # should list "ceoguy-x-algorithm-skill"
/plugin list                 # should list the "x-algorithm" plugin

Usage — how to actually use it

This plugin ships both a skill (auto-activated) and a slash command (explicit).

Option A — just describe what you want (skill auto-activates)