social-data

Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/social-data/SKILL.md

Quality

Content

92%

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

The body is highly actionable and token-efficient, with executable curl commands and no filler. Its only weakness is progressive disclosure: a flat inline catalog rather than an overview pointing to per-platform detail files.

Suggestions

Consider splitting each platform's API reference into a one-level-deep reference file (e.g. references/twitter.md) with a concise overview + links in SKILL.md.

Keep the current lean curl examples as-is when refactoring to preserve the strong conciseness and actionability scores.

Dimension	Reasoning	Score
Conciseness	The body is lean curl commands with only useful specifics (response shapes, query operators) and no re-explanation of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor.	3 / 3
Actionability	Every example is a fully executable, copy-paste-ready curl command with required headers and env vars (e.g. '-H "Authorization: Bearer $TWITTER_BEARER_TOKEN"'), matching the 'fully executable code/commands; copy-paste ready' anchor.	3 / 3
Workflow Clarity	This is a reference skill of single, unambiguous read-only fetch actions with no destructive or batch operations requiring validation checkpoints; per the simple-skills note, unambiguous single actions score 3.	3 / 3
Progressive Disclosure	Platform sections are well-organized and easy to navigate, but the entire API reference is inline in SKILL.md with no overview/detail split or external references, and the file exceeds the 50-line simple-skill threshold, matching the 'content that should be separate is inline' anchor rather than a 3.	2 / 3
	Total	11 / 12 Passed

Description

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is clear and distinctive about its social-data niche but stops short of a 3 by omitting explicit 'when to use' trigger guidance and a broader set of natural action keywords. Adding a 'Use when...' clause would lift completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants tweets, Reddit posts/comments, or Hacker News stories.

Expand action-oriented keywords beyond 'Search and fetch' to include concrete nouns users say (tweets, posts, comments, front page, subreddit).

Keep the third-person voice and conciseness intact when adding these triggers.

Dimension	Reasoning	Score
Specificity	Quotes "Search and fetch social media data from Twitter/X, Reddit, and Hacker News" name the domain and two actions (search, fetch) across three platforms, but the action list is not comprehensive enough for a 3.	2 / 3
Completeness	It clearly states what the skill does but lacks any 'Use when...' clause or equivalent trigger guidance, which the rubric caps at 2; it is not a 1 because the 'what' is explicit.	2 / 3
Trigger Term Quality	Platform names ("Twitter/X", "Reddit", "Hacker News") are natural terms, but common action-oriented variations users would say (tweets, posts, comments, front page) are missing, matching the 'some relevant keywords but missing common variations' anchor.	2 / 3
Distinctiveness Conflict Risk	The named-platform niche ("Twitter/X, Reddit, and Hacker News" social data) is clearly distinguishable with distinct triggers and unlikely to fire for unrelated skills.	3 / 3
	Total	9 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	14 / 16 Passed

Repository: Bitterbot-AI/bitterbot-desktop
Path: skills/social-data/SKILL.md
Commit: e73c717

Reviewed: about 16 hours 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.