A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
90
Quality
88%
Does it follow best practices?
Impact
97%
1.44xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
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 well-crafted skill description that excels across all dimensions. It provides specific capabilities, uses natural trigger terms that users would actually say, explicitly states both what the skill does and when to use it, and has a clear distinctive niche focused on X/Twitter API interactions.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media' - these are all distinct, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('CLI tool for making authenticated requests to X API') and when ('Use this skill when you need to post tweets, reply, quote, search...') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'X', 'Twitter', 'tweets', 'reply', 'quote', 'search', 'DMs', 'followers', 'media' - covers both platform names and common user actions. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche targeting X/Twitter specifically with platform-specific terminology (tweets, DMs, followers, X API v2). Unlikely to conflict with other social media or API skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill with excellent concrete examples and clear workflows. The security guidance is appropriately thorough. Main weaknesses are moderate verbosity and the monolithic structure - the content would benefit from splitting advanced topics into separate files and trimming some redundant explanations.
Suggestions
Split advanced topics (streaming, raw API access, multi-app management) into separate reference files linked from a 'See also' section
Consolidate the installation section to just the most common method (Homebrew or npm) with a link to full installation docs
Remove redundant security warnings that appear in multiple places - consolidate into a single 'Security' section at the top
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some redundancy (e.g., installation methods could be trimmed, some notes are repeated). The security warnings are appropriately detailed but the overall document could be tightened by ~20-30%. | 2 / 3 |
Actionability | Excellent executable examples throughout with copy-paste ready commands. Every command has concrete syntax, the quick reference table is immediately usable, and workflows show complete multi-step processes with actual commands. | 3 / 3 |
Workflow Clarity | Multi-step workflows (post with image, reply to conversation, search and engage) are clearly sequenced with numbered steps. The auth setup workflow includes explicit validation ('xurl auth status') and the media upload workflow shows the complete flow from upload to post. | 3 / 3 |
Progressive Disclosure | The document is well-structured with clear sections and a quick reference table, but it's a monolithic ~300 line file. Advanced topics like streaming, raw API access, and multi-app setup could be split into separate reference files with links from the main skill. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 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 | 9 / 11 Passed | |
8763418
Table of Contents
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.