{"_id":"x-algorithm-skill","_rev":"5-3f22b1926dcf638dcf1bd2912fe0396d","name":"x-algorithm-skill","dist-tags":{"latest":"1.2.1"},"versions":{"1.0.0":{"name":"x-algorithm-skill","version":"1.0.0","keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"author":{"name":"Dylan Buck"},"license":"MIT","_id":"x-algorithm-skill@1.0.0","maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"bin":{"x-algorithm-skill":"bin/x-algorithm-skill.cjs"},"dist":{"shasum":"ce0d2282ae333f35ae330be2412d6b7a275ca38c","tarball":"https://registry.npmjs.org/x-algorithm-skill/-/x-algorithm-skill-1.0.0.tgz","fileCount":6,"integrity":"sha512-mYudyDFJPzcLTyKangZDv77r/vjJGJeU+SXncjlqlfm/fbhVIGlz3erTlwYnbHerp/rRyud2iVITjV4rRzCpOw==","signatures":[{"sig":"MEYCIQChdYejYDulsfBmDwb4Us7wHHpHVjgUXwsDOv1Lw7vtpAIhAJgl7w/zBOF1Zj8KlKJEm8VnJY9P0trIsnB71aWZnJ7F","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48386},"type":"module","gitHead":"18cb8af903a537eec5aee3812fabe8ced38d618f","_npmUser":{"name":"djbuck","email":"db.vntrs@gmail.com"},"repository":{"url":"git+https://github.com/dylan-buck/x-algorithm-skill.git","type":"git"},"_npmVersion":"10.8.2","description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","directories":{},"_nodeVersion":"20.19.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/x-algorithm-skill_1.0.0_1768972664024_0.2233598084020778","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"x-algorithm-skill","version":"1.1.0","keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"author":{"name":"Dylan Buck"},"license":"MIT","_id":"x-algorithm-skill@1.1.0","maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"bin":{"x-algorithm-skill":"bin/x-algorithm-skill.cjs"},"dist":{"shasum":"34576f79229d0af62b9930b0316c178d2b964373","tarball":"https://registry.npmjs.org/x-algorithm-skill/-/x-algorithm-skill-1.1.0.tgz","fileCount":6,"integrity":"sha512-/Q4IBCo0fGGVvamGj0LYswaYjuA1Hcs4Z5bdNnPmS9BgFO/SWlXD6pLoHJQ+OjgiZsiE9f2yBMIohyePLfmr+w==","signatures":[{"sig":"MEUCIDyDKLyy52kOQ11tDu8kbGVmYxxS343YxmcIboagbmIFAiEA058HbNhzwGlYd2EzKb/d+1GY/mbmehym1h3U5oK/v+o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48707},"type":"module","gitHead":"18cb8af903a537eec5aee3812fabe8ced38d618f","_npmUser":{"name":"djbuck","email":"db.vntrs@gmail.com"},"repository":{"url":"git+https://github.com/dylan-buck/x-algorithm-skill.git","type":"git"},"_npmVersion":"10.8.2","description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","directories":{},"_nodeVersion":"20.19.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/x-algorithm-skill_1.1.0_1768974091018_0.584419180235489","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"x-algorithm-skill","version":"1.1.1","keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"author":{"name":"Dylan Buck"},"license":"MIT","_id":"x-algorithm-skill@1.1.1","maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"bin":{"x-algorithm-skill":"bin/x-algorithm-skill.cjs"},"dist":{"shasum":"e77affaf7a05bbdc752973bf69a092b164d447a1","tarball":"https://registry.npmjs.org/x-algorithm-skill/-/x-algorithm-skill-1.1.1.tgz","fileCount":6,"integrity":"sha512-xvHBeMQIlBgOrT/PuvYChJvhk8ADsr/SIGxgO01TcdGkQjcaBJvceN+U46GizbIAzyZNU9yIxV7l+sKlWCj+PA==","signatures":[{"sig":"MEQCIDNBJ3jwjaQRUpt/tpUloBeqw4OrL2MAAHPx4CiueIaEAiAyRzHHq34OzIomQhEsSWe7TeQn1RfEDkBQpVQDqn7ynA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48771},"type":"module","gitHead":"3515a9109cab884210bb322489ef22f735eb846d","_npmUser":{"name":"djbuck","email":"db.vntrs@gmail.com"},"repository":{"url":"git+https://github.com/dylan-buck/x-algorithm-skill.git","type":"git"},"_npmVersion":"10.8.2","description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","directories":{},"_nodeVersion":"20.19.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/x-algorithm-skill_1.1.1_1768976891634_0.9581193210747065","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"x-algorithm-skill","version":"1.2.0","keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"author":{"name":"Dylan Buck"},"license":"MIT","_id":"x-algorithm-skill@1.2.0","maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"bin":{"x-algorithm-skill":"bin/x-algorithm-skill.js"},"dist":{"shasum":"16bf9426309006e3b11fbac4f6cf107bbe3abf54","tarball":"https://registry.npmjs.org/x-algorithm-skill/-/x-algorithm-skill-1.2.0.tgz","fileCount":6,"integrity":"sha512-bIUebUHuJrUktMI/ar/U/0+CxY3I6gUlXgePIPUJs9XRK6ro8fg/+0EITNgWyJ6mXYt25M4JA9DD8U2PozQ4ow==","signatures":[{"sig":"MEQCIG6p8ddOQywD4Gshm2nk8cik4cbELYWu37pxFX9OiyO9AiAY05X1MF/CFGRzj9hYlNndxR5TcKbh8WZ7ORhxS8MPuQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62583},"type":"module","gitHead":"fa2653bca49c4b79c8f98e41571ba58e1b0e077c","_npmUser":{"name":"djbuck","email":"db.vntrs@gmail.com"},"repository":{"url":"git+https://github.com/dylan-buck/x-algorithm-skill.git","type":"git"},"_npmVersion":"10.8.2","description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","directories":{},"_nodeVersion":"20.19.1","dependencies":{"update-notifier":"^7.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/x-algorithm-skill_1.2.0_1768978158477_0.9229061713823346","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"x-algorithm-skill","version":"1.2.1","description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","type":"module","bin":{"x-algorithm-skill":"bin/x-algorithm-skill.js"},"keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"author":{"name":"Dylan Buck"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/dylan-buck/x-algorithm-skill.git"},"homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"dependencies":{"update-notifier":"^7.3.1"},"_id":"x-algorithm-skill@1.2.1","gitHead":"63ac9fb1710cf5bb0e98970247bd80da7507ee92","_nodeVersion":"20.19.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-L/LSzIlM2utxVe+HSOw/nXMc368EpvAWq1vwhWWgLmOxtRRkZgjm6LKF+JMit3a1x575gKNhEvgaSk7gG/oepw==","shasum":"f599c8b7820a808ef8fd4fc9b52dd1429e43707d","tarball":"https://registry.npmjs.org/x-algorithm-skill/-/x-algorithm-skill-1.2.1.tgz","fileCount":6,"unpackedSize":63490,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDjpzkgjNpPqmLMhFL0IQkZOnjvjWx6ahi1Vf9OjLuDzQIgUwfdvisxatKI4BiDiJdqU4Mpn7PtCsOT1L4GelaXFls="}]},"_npmUser":{"name":"djbuck","email":"db.vntrs@gmail.com"},"directories":{},"maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/x-algorithm-skill_1.2.1_1768979068859_0.3828927778592026"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-21T05:17:43.863Z","modified":"2026-01-21T07:04:29.147Z","1.0.0":"2026-01-21T05:17:44.164Z","1.1.0":"2026-01-21T05:41:31.206Z","1.1.1":"2026-01-21T06:28:11.786Z","1.2.0":"2026-01-21T06:49:18.636Z","1.2.1":"2026-01-21T07:04:29.012Z"},"bugs":{"url":"https://github.com/dylan-buck/x-algorithm-skill/issues"},"author":{"name":"Dylan Buck"},"license":"MIT","homepage":"https://github.com/dylan-buck/x-algorithm-skill#readme","keywords":["x","twitter","algorithm","viral","social-media","claude","claude-code","skill"],"repository":{"type":"git","url":"git+https://github.com/dylan-buck/x-algorithm-skill.git"},"description":"Write viral X posts using deep knowledge of the actual recommendation algorithm","maintainers":[{"name":"djbuck","email":"db.vntrs@gmail.com"}],"readme":"# X Algorithm Skill\n\nWrite viral X posts using deep knowledge of the actual recommendation algorithm.\n\nThis skill gives Claude Code (and other AI tools) detailed knowledge of how X's \"For You\" feed algorithm works, enabling it to help you write posts optimized for maximum reach.\n\n## Installation\n\n```bash\nnpx x-algorithm-skill init\n```\n\nOr install globally:\n\n```bash\nnpm install -g x-algorithm-skill\nx-algorithm-skill init\n```\n\n## Usage\n\nAfter installation, use the skill in Claude Code:\n\n### Get Writing Guidance\n```\n/x-algorithm\n```\nDisplays an overview of the algorithm and guidance for writing viral posts.\n\n### Review a Draft\n```\n/x-algorithm review\n\nHere's my draft: [your draft]\n```\nGet algorithm-backed feedback on your draft with specific improvements.\n\n## What's Inside\n\nThe skill teaches Claude about:\n\n- **Scoring Signals**: The 19 engagement signals the algorithm predicts (replies, shares, dwell time, etc.) and their relative weights\n- **Retrieval & Discovery**: How the two-tower neural network finds relevant posts for users\n- **Content Structure**: Optimal formatting for dwell time and engagement\n- **Viral Patterns**: 8 proven templates that trigger high-value signals\n- **Anti-Patterns**: What gets penalized (engagement bait, rage bait, over-posting)\n- **Iteration Framework**: A systematic checklist for improving drafts\n\n## How It Works\n\nX's \"For You\" feed is powered by:\n\n1. **Phoenix Retrieval**: Two-tower neural network that matches post embeddings to user interest embeddings\n2. **Phoenix Ranking**: Grok transformer that predicts 19 engagement probabilities\n3. **Weighted Scoring**: Probabilities × weights = final score\n4. **Penalties**: Out-of-network penalty, author diversity decay, age filtering\n\nThis skill encodes all of this into actionable guidance.\n\n## The Key Insight\n\nThe algorithm doesn't care about \"engagement\" generically. It cares about **specific actions**:\n\n- **High-value**: Replies, DM shares, copy-link shares, dwell time, follows\n- **Medium-value**: Likes, retweets, profile clicks\n- **Negative**: Not interested, mute, block, report\n\nA post with 50 likes and 20 replies scores better than one with 100 likes and 0 replies.\n\n## Source\n\nThis skill is based on analysis of the open-sourced X recommendation algorithm:\n- [X For You Feed Algorithm](https://github.com/dylan-buck/claude-x-skill)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}