twitter-reader
Fetch Twitter/X post content including long-form Articles with full images and metadata. Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media. Supports individual posts and X Articles (long-form content). Automatically downloads all images to local attachments folder and generates complete Markdown with proper image references. Preferred over Jina for X Articles with images.
86
82%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly communicates what the skill does (fetches Twitter/X content with images and metadata), when to use it (retrieving tweets, articles, author info, engagement metrics), and how it differentiates from alternatives (preferred over Jina for X Articles with images). The description is specific, uses natural trigger terms, and has a clear niche.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: fetch post content, retrieve tweet/article content, author info, engagement metrics, embedded media, download images to local attachments folder, generate Markdown with image references. | 3 / 3 |
Completeness | Clearly answers both what ('Fetch Twitter/X post content including long-form Articles with full images and metadata') and when ('Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media'). Explicit 'Use when' clause is present. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Twitter', 'X', 'post', 'tweet', 'article', 'images', 'engagement metrics', 'media'. Also includes the alternative tool name 'Jina' for disambiguation. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — clearly scoped to Twitter/X content specifically, with explicit differentiation from Jina for X Articles with images. Unlikely to conflict with general web scraping or other social media skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with clear executable commands and good examples. Its main weaknesses are moderate redundancy across sections (features listed multiple times in different formats) and the absence of error handling or validation guidance. The content would benefit from consolidation of repeated information and addition of troubleshooting steps.
Suggestions
Consolidate the 'Features', 'What Gets Returned', and 'Scripts' sections to eliminate redundant descriptions of the same tools and their capabilities.
Add error handling guidance: what happens when twitter-cli fails, when images fail to download, or when an invalid URL is provided, and how to recover.
Remove the 'Migration from Jina API' section — it's only 2 commands and the distinction is already clear from the Quick Start vs Alternative sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some redundancy — the features are listed in a summary table and then repeated in 'What Gets Returned' and 'Scripts' sections. The 'Example Output' showing terminal output is helpful but adds bulk. Some sections like 'Migration from Jina API' and the repeated script descriptions could be trimmed. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready commands for both the primary workflow (fetch_article.py) and the alternative (Jina API). Includes concrete examples with real URLs, environment variable setup, and clear script invocations with arguments. | 3 / 3 |
Workflow Clarity | The Quick Start section clearly describes what the script does in sequence, and the example output shows expected behavior. However, there are no validation checkpoints or error handling guidance — no mention of what to do if twitter-cli fails, if images fail to download, or if the URL format is wrong. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and headers, but it's somewhat monolithic — all content is inline in a single file. The repeated information across sections (Features, What Gets Returned, Scripts) suggests the content could be better organized. No references to external documentation files. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- daymade/claude-code-skills
- Commit
80e94fd
- Reviewed
Table of Contents
Is this your skill?
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.