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

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Advisory

Suggest reviewing before use

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is actionable and well-structured with verified bundle scripts, but it carries redundant sections and lacks a verification step for the batch image download. Tightening repetition and adding a validation checkpoint would raise the weakest dimensions.

Suggestions

Remove the redundant 'Scripts' section — fetch_article.py and fetch_tweet.py usage is already shown in Quick Start and Alternative; consolidate to a single location to save tokens.

Replace or trim the full 'Example Output' terminal transcript, which duplicates the 'This will:' bullet list without adding actionable guidance.

Add a verification checkpoint after the batch image download (e.g. confirm the downloaded image count matches the expected count and re-run on partial failure) to harden the workflow against dropped images.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with no concept-padding, but the 'Scripts' section repeats fetch_article.py/fetch_tweet.py usage already shown in Quick Start and Alternative, and the full 'Example Output' terminal transcript duplicates the 'This will' bullets — tightening opportunities remain.	2 / 3
Actionability	Commands are fully executable and copy-paste ready (e.g. 'uv run --with pyyaml python scripts/fetch_article.py <article_url> [output_dir]'), and every referenced script (fetch_article.py, fetch_tweet.py, fetch_tweets.sh) exists in the bundle.	3 / 3
Workflow Clarity	The 'This will:' list sequences the steps, but the batch image download has no validation/verification checkpoint in the skill, which caps workflow clarity at 2 per the batch-operations guideline.	2 / 3
Progressive Disclosure	Well-organized sections (Quick Start, Alternative, Features, Output Structure) with one-level-deep references to real bundle scripts and clear navigation; no nested reference chains.	3 / 3
	Total	10 / 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.

A strong, third-person description that clearly states capabilities, includes explicit trigger guidance, and positions the skill distinctly. It avoids verbosity and over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Fetch Twitter/X post content including long-form Articles', 'Automatically downloads all images to local attachments folder and generates complete Markdown' — matching the multiple-specific-actions anchor rather than the single-domain level 2.	3 / 3
Completeness	Explicitly answers both what (fetch content, images, metadata) and when via the 'Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media' clause, meeting the level 3 anchor.	3 / 3
Trigger Term Quality	Covers natural terms a user would say — 'Twitter/X', 'tweet/article content', 'X Articles' — with good variation; not merely technical jargon like the level 1 anchor.	3 / 3
Distinctiveness Conflict Risk	Clear niche (Twitter/X reading) with distinct triggers and explicit positioning ('Preferred over Jina for X Articles with images'), unlikely to conflict with other 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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: daymade/claude-code-skills
Path: twitter-reader/SKILL.md
Commit: b3b4af8

Reviewed: 8 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.