CtrlK
BlogDocsLog inGet started
Tessl Logo

twitter

Search and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io. Use when user mentions Twitter, X, or tweets.

89

5.61x
Quality

93%

Does it follow best practices?

Impact

73%

5.61x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

An exemplary command-catalog skill: lean, fully executable, accurately mirroring the real scripts in the bundle, and cleanly organized by endpoint category. The only gaps are workflow niceties — no troubleshooting path for a failed Quick Check and no mention of pagination via --cursor.

Suggestions

Add one line after the Quick Check describing what to do on failure (e.g., missing TWITTERAPI_API_KEY or a dependency error) to close the feedback loop.

Document the --cursor pagination flag shown by the scripts (e.g., how to continue a truncated result set from the cursor printed by print_pagination).

DimensionReasoningScore

Conciseness

The body is almost entirely executable commands with placeholder arguments and one-line notes (e.g., "# Worldwide"), with zero explanation of concepts Claude already knows — no "what is Twitter" or "how APIs work" padding. Every section (Prerequisites, Commands, Search Query Syntax, API) earns its tokens, matching 'Lean and efficient; every token earns its place'.

5 / 5

Actionability

Every command is fully executable as written (e.g., `python3 scripts/get_user_info.py elonmusk`, `python3 scripts/search_tweets.py "AI min_faves:1000"`), all 26 referenced scripts exist in scripts/ with matching argument shapes, and the Quick Check gives a copy-paste verification path. This matches the score-5 'Fully executable; copy-paste ready commands covering the common cases' anchor.

5 / 5

Workflow Clarity

The sequence is clear — set API key in ~/.zshrc, run the Quick Check to validate, then run endpoint commands — and all operations are read-only so no destructive-validation cap applies. However, there is no error-recovery guidance (what to do when the Quick Check fails) and the --cursor pagination flag visible in the scripts is never explained, so it sits at 'Clear sequence with most checkpoints present; minor validation gaps' rather than the score-5 anchor requiring explicit feedback loops.

4 / 5

Progressive Disclosure

Scored against the actual bundle: SKILL.md is a well-organized command index grouped by endpoint category (User/Tweet/List/Community/Other), and every one-level-deep reference (scripts/*.py) is a real file reachable via the listed command. Detail lives in the scripts, nothing that belongs in a separate file is inlined, and the brief API footer (base URL, auth, pricing, docs) is appropriately placed. This matches 'Clear overview with well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

19

/

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 description: concrete, comprehensive capability list in third-person imperative voice, an explicit 'Use when' trigger clause, and unambiguous niche boundaries. The only weakness is modest trigger-term breadth — a few natural user phrasings (retweet, profile, handle, timeline) are absent.

DimensionReasoningScore

Specificity

"Search and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io" lists multiple specific concrete actions covering the full endpoint surface. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds the score-4 anchor, which expects minor gaps in coverage.

5 / 5

Completeness

The 'what' is explicit and concrete ("Search and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io") and the 'when' is an explicit trigger clause ("Use when user mentions Twitter, X, or tweets"). Both are clearly and explicitly answered with concrete trigger phrases, matching the score-5 anchor; it is above score 4, where the 'when' would be less specific.

5 / 5

Trigger Term Quality

"Use when user mentions Twitter, X, or tweets" includes the core natural terms (Twitter, X, tweets) plus domain nouns like followers, spaces, and trends in the capability list. It misses common variations users would say — e.g., "retweet", "DM", "profile", "handle", "timeline" — so it fits 'Good keyword coverage; a few natural terms missing' rather than the score-5 comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Twitter/X data via twitterapi.io) with distinct triggers — "Twitter, X, or tweets" — that no other plausible skill would claim, matching 'Clear niche with distinct triggers; minimal conflict risk'. It is clearly more distinct than the score-4 anchor, which still expects overlap with closely related skills.

5 / 5

Total

19

/

20

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

Validation for skill structure

No warnings or errors.

Repository
ReScienceLab/opc-skills
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.