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.

Quality

82%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Quality

Content

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 clear, actionable commands for fetching Twitter/X content with good concrete examples and real URLs. Its main weaknesses are moderate redundancy across sections (Features, What Gets Returned, Scripts all overlap) and the absence of error handling or validation guidance for network-dependent operations. Tightening the structure and adding error recovery steps would significantly improve it.

Suggestions

Consolidate the 'Features', 'What Gets Returned', and 'Scripts' sections to eliminate redundancy—a single reference table per mode would suffice.

Add error handling guidance: what to do when network requests fail, when twitter-cli isn't available, or when image downloads partially fail.

Remove the 'Migration from Jina API' section or fold it into a single line—it adds little value for Claude's task execution.

Dimension	Reasoning	Score
Conciseness	The content is mostly efficient but includes some redundancy—features are listed in a summary table AND described in detail sections, the 'What Gets Returned' section largely duplicates 'Features', and the migration section adds marginal value. The example output block is helpful but lengthy.	2 / 3
Actionability	Provides fully executable, copy-paste ready commands for both the primary workflow (fetch_article.py) and the alternative (Jina API). Concrete examples with real URLs, specific flags, and clear output expectations make this highly actionable.	3 / 3
Workflow Clarity	The primary workflow is clear as a single command, but there are no validation or error-handling steps mentioned—what if twitter-cli fails, images fail to download, or the URL is invalid? For a tool that performs network fetches and file writes, some error recovery guidance would be expected.	2 / 3
Progressive Disclosure	The content is reasonably structured with clear sections, but it's somewhat monolithic for its length (~130 lines). The 'What Gets Returned', 'Features', and 'Scripts' sections overlap significantly. Without bundle files, references to scripts like fetch_article.py and fetch_tweets.sh can't be verified, but the organization could be tighter.	2 / 3
	Total	9 / 12 Passed

Description

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, lists concrete capabilities, includes natural trigger terms covering both 'Twitter' and 'X' naming conventions, and explicitly states when to use it. The disambiguation against Jina is a nice touch for reducing conflict risk. The description is well-structured and appropriately detailed without being 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, download images, generate Markdown) and when ('Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media'). Explicit trigger guidance 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 with a clear niche focused on Twitter/X content retrieval. The explicit comparison 'Preferred over Jina for X Articles with images' further disambiguates it from similar web-fetching skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

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: 0f104ea

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.