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 is strong in specificity and distinctiveness, clearly articulating what the skill does (analyze, optimize, rewrite tweets) and carving out a unique niche around Twitter's algorithm. However, it lacks an explicit 'Use when...' clause which limits its completeness score, and could benefit from broader trigger term coverage including the platform's rebrand to 'X' and common user phrasings.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks for help writing tweets, improving tweet engagement, going viral, or optimizing social media posts for Twitter/X.'
Include additional trigger terms like 'X', 'post', 'viral', 'impressions', 'social media optimization', and 'tweet performance' to capture more natural user phrasings.
| 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). However, there is no explicit 'Use when...' clause or equivalent trigger guidance — the when is only implied by the nature of the actions described. Per rubric guidelines, missing 'Use when' caps completeness at 2. | 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'. A user might say 'help me write a better tweet' which would partially match. | 2 / 3 |
Distinctiveness Conflict Risk | This is clearly scoped to Twitter/tweet optimization using algorithm insights, which is a distinct niche. It's unlikely to conflict with general writing skills or other social media skills due to the specific mention of Twitter's recommendation system and algorithm. | 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 and the optimization framework is reasonable, the content is bloated with background explanations Claude doesn't need, redundant sections (When to Use, What This Skill Does, When to Ask), and no progressive disclosure structure. The core actionable content could be distilled to roughly 80-100 lines.
Suggestions
Cut the algorithm architecture section to a brief summary table (signal type → weight → strategy) and move detailed explanations to a separate ALGORITHM_DETAILS.md reference file.
Remove the 'When to Use This Skill' and 'What This Skill Does' meta-sections entirely — these duplicate the YAML description and waste tokens.
Add a concrete scoring checklist or template that Claude can mechanically apply to any tweet (e.g., '☐ Has question/CTA ☐ Targets specific community ☐ No negative signal risk') as a validation checkpoint.
Consolidate the 3 detailed examples into a compact before→after format and move to an EXAMPLES.md file, keeping only one inline example in the main skill.
| 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 genuinely useful. However, there's no executable code, no specific commands, and the guidance is more strategic advice than precise, copy-paste-ready instructions. The optimization steps are somewhat generic ('identify the core message', 'map to algorithm strategy') rather than providing a tight, repeatable template or scoring rubric Claude could mechanically apply. | 2 / 3 |
Workflow Clarity | The 4-step optimization process (Identify Core Message → Map to Algorithm Strategy → 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, no criteria for 'good enough', and no iterative refinement step. For a content editing workflow, a before/after checklist or scoring mechanism would strengthen this. | 2 / 3 |
Progressive Disclosure | Monolithic wall of text with no references to external files and no bundle files to support it. All content — algorithm architecture, optimization strategies, examples, best practices, pitfalls — is crammed into a single file. The algorithm architecture section alone could be a separate reference file, and the examples could be in an EXAMPLES.md. No navigation aids or clear separation between overview and deep-dive content. | 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 | |
c911a92
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.