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.
68
82%
Does it follow best practices?
Impact
—
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 its purpose, capabilities, and when to use it. It includes excellent trigger terms covering both 'Twitter' and 'X' naming conventions, lists specific capabilities like image downloading and Markdown generation, and even provides disambiguation guidance against a competing skill (Jina). The description is well-structured and comprehensive without being unnecessarily verbose.
| 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', 'tweet', 'post', 'article', 'images', 'engagement metrics', 'author info'. 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 skill provides strong actionability with concrete, executable commands and a clear example of expected output. However, it suffers from moderate redundancy across sections (Features, What Gets Returned, Scripts all partially restate the same information) and lacks error handling or validation guidance for network-dependent operations. Tightening the content and adding basic error recovery steps would significantly improve it.
Suggestions
Consolidate the Features, What Gets Returned, and Scripts sections — much of this information is already conveyed in the Quick Start and Alternative sections, reducing redundancy would improve conciseness.
Add error handling guidance: what to do if twitter-cli fails to authenticate, if image downloads are incomplete, or if the Jina API returns an error.
Remove the Migration section or reduce it to a single line — Claude doesn't need historical context about workflow changes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundancy — the Features section largely repeats what's already shown in Quick Start and Alternative sections. The 'What Gets Returned' section also overlaps with the example output and Features sections. The Migration section adds marginal value. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready commands for both the primary (fetch_article.py) and alternative (Jina API) workflows. Concrete examples with real URLs, specific flags, and clear output expectations are included. | 3 / 3 |
Workflow Clarity | The primary workflow is clear as a single command, and the example output shows what to expect. However, there are no validation or error-handling steps — no guidance on what to do if twitter-cli fails, if images fail to download, or if the output is incomplete. For a tool that does network fetching and file I/O, some error recovery guidance would be appropriate. | 2 / 3 |
Progressive Disclosure | The content is reasonably well-structured with clear sections, but it's somewhat monolithic — the Features, What Gets Returned, and Scripts sections could be trimmed since they repeat information already demonstrated. No bundle files are provided, so there are no external references to evaluate, but the content length (~120 lines) suggests some sections could be consolidated. | 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
bbf87f3
- 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.