bundles/content/skills/x-algorithm-optimizer/SKILL.md
Optimizes X/Twitter content for algorithm engagement signals using xai-org/x-algorithm's Grok transformer predictions. Activates for tweet optimization, thread strategy, X growth, algorithm-aligned content, improving X/Twitter engagement, or maximizing reach on X.
npx skillsauth add shipshitdev/library x-algorithm-optimizerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Optimize content for X's algorithm based on actual engagement signal prediction (from xai-org/x-algorithm).
Core Insight: X's algorithm uses Grok-based transformers to predict 15 user-specific engagement signals. It optimizes for user relevance, not broad popularity.
X's algorithm predicts these signals per-user:
| Signal | Weight | Optimization Strategy | |--------|--------|----------------------| | Favorites | High | Relatable insights, contrarian takes, save-worthy content | | Replies | Very High | Questions, open loops, controversial hooks | | Reposts | Very High | Frameworks, data, templates, quotable insights | | Quotes | High | Hot takes people want to add to | | Shares | High | Actionable value, resources, tools | | Profile Clicks | High | Credibility signals, mysterious bio hooks | | Video Views | Medium | Hook in first 3s, text overlay, no slow intros | | Photo Expansions | Medium | Intriguing cropped previews, charts, screenshots | | Dwell Time | Very High | Long-form hooks, formatting, open loops | | Follows | Very High | Consistent niche value, credibility proof |
| Signal | Trigger | Avoidance Strategy | |--------|---------|-------------------| | Not Interested | Irrelevant content | Stay on-niche, clear topic signals | | Blocks | Aggressive/spam behavior | No mass mentions, no DM spam | | Mutes | Posting frequency overload | Space out content, quality > quantity | | Reports | Policy violations | Clean content, no engagement bait |
Dwell time is critical. Stop the scroll with these patterns:
Most people think [common belief].
They're wrong.
Here's why:
I've [impressive credential].
Here's what I learned:
[Surprising statistic].
That's [comparison that makes it shocking].
In [year], I was [relatable situation].
[Unexpected outcome] changed everything.
Why do [successful people] always [behavior]?
I studied [number] of them. Here's the pattern:
[Number]% of people will never know this.
[Valuable insight]:
Replies signal high engagement value to the algorithm.
End tweets without full resolution:
Content people save and share:
The [Name] Framework for [Outcome]:
1. [Step with benefit]
2. [Step with benefit]
3. [Step with benefit]
Steal this.
Here's the exact [template/script/email] I used to [outcome]:
[Template]
Copy and use it.
I analyzed [number] [things].
Here's what the data shows:
[Insight 1]
[Insight 2]
[Insight 3]
Bookmark this.
[Number] [tools/resources/tips] that [benefit]:
1. [Name] - [1-line description]
2. [Name] - [1-line description]
...
Save for later.
Threads cascade engagement across tweets.
Tweet 1 (Hook): Stop the scroll, promise value
Tweet 2-6 (Body): Deliver value, one point per tweet
Tweet 7 (CTA): Follow, engage, or take action
I [credibility signal].
Here's [what I learned / my framework / the breakdown]:
(Thread)
The algorithm attenuates repeated creators in feeds. Implications:
Content is scored per-user, not globally. Implications:
The model is pure ML prediction. Implications:
| Audience Type | Best Times | Why | |--------------|------------|-----| | B2B/Tech | 8-10am, 12-1pm EST | Work hours, lunch breaks | | B2C/Lifestyle | 7-9am, 7-10pm EST | Before/after work | | Global | Varies | Test and measure |
Note: Timing matters less than content quality. A great tweet at 2am beats a mediocre tweet at peak time.
| Skill | When to Use |
|-------|-------------|
| content-creator | Generate tweet/thread content |
| copywriter | Brand voice consistency |
| prompt-engineering | Content generation prompts |
| youtube-video-analyst | Apply hook patterns from video |
For detailed signal tactics and examples: references/engagement-signals.md
development
TypeScript refactoring and modernization guidelines from a principal specialist perspective. This skill should be used when refactoring, reviewing, or modernizing TypeScript code to ensure type safety, compiler performance, and idiomatic patterns. Triggers on tasks involving TypeScript type architecture, narrowing, generics, error handling, or migration to modern TypeScript features.
tools
Resolves TypeScript and JavaScript problems across type-level programming, performance, monorepo management, migration, and modern tooling. Invoke when diagnosing "type instantiation excessively deep" errors, migrating JS to TS, configuring strict tsconfig, debugging module resolution, or choosing between Biome/ESLint/Turborepo/Nx.
tools
Turborepo monorepo build system guidance. Triggers on: `turbo.json`, task pipelines, `dependsOn`, caching, remote cache, the `turbo` CLI, `--filter`, `--affected`, CI optimization, environment variables, internal packages, monorepo structure, and package boundaries. Use when the user configures tasks or workflows, creates packages, sets up a monorepo, shares code between apps, runs changed packages, debugs cache behavior, or works in an `apps/` plus `packages/` workspace.
tools
Provides Tailwind CSS v4 performance optimization and best practices guidelines. Triggers when writing, reviewing, or refactoring Tailwind CSS v4 code; when working with Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.