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.
95
Quality
96%
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) that would not conflict with other social media or API skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill document that provides comprehensive, actionable guidance for using the xurl CLI tool. It excels at conciseness through effective use of tables and code examples, and includes strong security guidance around credential handling. The main weakness is that the document is lengthy and could benefit from splitting detailed command references into separate files for better progressive disclosure.
Suggestions
Consider moving the detailed 'Command Details' section to a separate COMMANDS.md file, keeping only the Quick Reference table in the main skill
The 'Raw API Access' and 'Streaming' sections could be consolidated into an ADVANCED.md file with a brief mention and link in the main document
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, using tables for quick reference, avoiding explanations of basic concepts, and assuming Claude understands CLI tools and APIs. Every section serves a clear purpose without padding. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready commands throughout. Every action has concrete examples with real command syntax, flags, and expected patterns. The quick reference table and detailed command sections give specific, actionable guidance. | 3 / 3 |
Workflow Clarity | Multi-step workflows (post with media, reply to conversation, search and engage) are clearly sequenced with numbered steps. The auth setup includes explicit validation via 'xurl auth status' and clear separation of manual vs automated steps. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections and a quick reference table, but the document is quite long (~300 lines) and could benefit from splitting detailed command references into a separate file. All content is inline rather than using external references for advanced topics. | 2 / 3 |
Total | 11 / 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 | |
50ef2f3
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.