Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit user tweets to improve engagement and visibility based on how the recommendation system ranks content.
65
47%
Does it follow best practices?
Impact
97%
1.31xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/twitter-algorithm-optimizer/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description does a good job specifying concrete capabilities around tweet optimization and clearly occupies a distinct niche. However, it lacks an explicit 'Use when...' clause which limits its completeness score, and it could benefit from broader trigger term coverage including modern terminology like 'X' and common user phrases like 'make my tweet go viral'.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to improve a tweet, optimize a post for Twitter/X, or wants help maximizing engagement on social media.'
Include additional natural trigger terms users would say, such as 'X', 'post', 'viral', 'impressions', 'likes', 'retweets', and 'social media optimization'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Analyze and optimize tweets', 'Rewrite and edit user tweets', 'improve engagement and visibility', and references 'recommendation system ranks content'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | The 'what' is well-covered (analyze, optimize, rewrite tweets for engagement), but there is no explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the nature of the actions described. | 2 / 3 |
Trigger Term Quality | Includes good terms like 'tweets', 'Twitter', 'engagement', 'reach', and 'algorithm', but misses common user variations like 'X' (Twitter's rebrand), 'post', 'thread', 'viral', 'impressions', or 'social media'. The term 'recommendation system ranks content' is more technical than what users would naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | This is clearly scoped to Twitter/tweet optimization using algorithm insights, which is a distinct niche unlikely to conflict with other skills. The combination of Twitter-specific terminology and algorithm-based optimization creates a clear identity. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is extremely verbose and reads more like a blog post or educational article about Twitter's algorithm than a concise, actionable skill for Claude. While the before/after tweet examples are genuinely useful, the bulk of the content is background explanation that Claude doesn't need spelled out in this detail. The lack of any bundle structure means everything is in one massive file with no progressive disclosure.
Suggestions
Cut the skill by at least 60%: remove the entire 'How It Works: Twitter's Algorithm Architecture' section and distill it into a brief reference table of signals and their weights. Claude doesn't need paragraphs explaining what Real-graph or SimClusters do.
Remove the 'When to Use This Skill' and 'What This Skill Does' meta-sections entirely — these duplicate the frontmatter description and waste tokens.
Split into multiple files: keep SKILL.md as a concise optimization workflow with 1-2 examples, and move detailed algorithm explanations, additional examples, and best practices into separate referenced files (e.g., ALGORITHM_SIGNALS.md, EXAMPLES.md).
Add a validation/feedback step to the workflow — e.g., 'Compare the optimized tweet against the original: does it maintain the author's voice? Does it target at least 2 engagement signals? If not, revise.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~300+ lines. Extensively explains how Twitter's algorithm works (Real-graph, SimClusters, TwHIN, Tweepcred) — concepts Claude could look up or already knows. The 'When to Use This Skill' and 'What This Skill Does' sections are redundant meta-descriptions. Much of the algorithm architecture section is background knowledge that doesn't need to be in a skill file. Could be cut by 60-70% without losing actionable value. | 1 / 3 |
Actionability | Provides concrete before/after tweet examples and a 4-step optimization process, which is useful. However, there's no executable code, no specific commands, and much of the guidance is strategic advice rather than precise, copy-paste-ready instructions. The optimization steps are more of a checklist than truly executable guidance — they describe what to think about rather than exactly what to do. | 2 / 3 |
Workflow Clarity | The 4-step optimization process (Identify Core Message → Map to Algorithm → Optimize for Signals → Check Against Negatives) provides a clear sequence. However, there are no validation checkpoints or feedback loops — no way to verify if the optimization actually improved the tweet before posting. For a skill involving content editing/rewriting, there should be a review/comparison step. | 2 / 3 |
Progressive Disclosure | Monolithic wall of text with no references to external files and no bundle files. All content — algorithm architecture, optimization strategies, examples, best practices, pitfalls — is crammed into a single massive document. The algorithm architecture details, extensive examples, and best practices sections could easily be split into separate reference files. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d065ead
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.