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

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

68%Weight 40%Scale 1-5

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

Highly actionable with real, executable bundle scripts, but the body is structurally repetitive and lacks validation checkpoints for its batch/download workflows. Consolidating redundant sections and adding a verify-on-error step would lift both conciseness and workflow clarity.

Suggestions

Consolidate the duplicate fetch_article.py usage (Quick Start, example, Scripts) into one authoritative section and remove the overlapping Features/Output Structure/What Gets Returned content.

Add an explicit validation/retry checkpoint for batch fetching and image downloads (e.g., verify expected image count, re-fetch failures) so the workflow clears the batch-operation cap.

Drop or compress the 'Migration from Jina API' section, which restates commands already shown in Quick Start and the Scripts section.

Dimension	Reasoning	Score
Conciseness	Mostly useful but noticeably repetitive: the fetch_article.py invocation recurs in Quick Start, the example, and the Scripts section, while Features, Output Structure, and What Gets Returned overlap — the body could be tightened by consolidating these.	3 / 5
Actionability	Provides copy-paste-ready, executable commands for every mode (uv run fetch_article.py, curl to r.jina.ai, fetch_tweets.sh, fetch_tweet.py), and all referenced scripts exist as real bundle files.	5 / 5
Workflow Clarity	The fetch sequence is listed (metadata, content+images, download, generate Markdown) but the batch path (fetch_tweets.sh) and image downloads lack explicit validation or error-recovery checkpoints, capping workflow clarity per the batch-operation rule.	3 / 5
Progressive Disclosure	Well-organized sections with clearly signaled, one-level-deep references to real scripts in scripts/ (fetch_article.py, fetch_tweet.py, fetch_tweets.sh); minor gaps where inlined feature/output content could be consolidated.	4 / 5
	Total	15 / 20 Passed

Description

92%Weight 40%Scale 1-5

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, specific description with clear what/when structure and explicit trigger guidance. Minor room to add natural synonyms like 'thread' for the broadest keyword coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Fetch Twitter/X post content', 'retrieve tweet/article content, author info, engagement metrics', 'Automatically downloads all images', 'generates complete Markdown with proper image references' — giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers both what (fetch content/images/metadata, download images, generate Markdown) and when ('Use when Claude needs to retrieve tweet/article content...'; 'Preferred over Jina for X Articles with images') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural-term coverage with synonyms (Twitter/X, tweet/article, posts) and 'embedded media'; a few natural variations like 'thread' are absent, so it falls just short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	Carves a clear niche (Twitter/X content with image download) and explicitly differentiates ('Preferred over Jina for X Articles with images'), minimizing overlap with generic fetcher skills.	5 / 5
	Total	19 / 20 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: b8556f2

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