xurl
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.
86
82%
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 strong skill description that clearly identifies the tool's purpose, lists specific capabilities, and provides explicit trigger guidance with a 'Use this skill when...' clause. It uses third person voice appropriately and includes both the old ('Twitter') and new ('X') brand names for maximum discoverability. The description is concise yet comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, and interact with X API v2 endpoints. | 3 / 3 |
Completeness | Clearly answers both what ('A CLI tool for making authenticated requests to the X (Twitter) API') and when ('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'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'tweets', 'reply', 'quote', 'search', 'DMs', 'followers', 'X', 'Twitter', 'upload media', 'post'. Good coverage of common variations including both 'X' and 'Twitter'. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to X/Twitter API interactions with distinct triggers like 'tweets', 'DMs', 'followers', and 'X API v2'. Unlikely to conflict with other skills unless there are multiple Twitter-related skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a highly actionable skill with excellent concrete examples covering the full xurl CLI surface area. Its main weaknesses are redundancy (quick reference table + command details + common workflows all overlap significantly) and lack of validation/verification steps in workflows. The security constraints around credential handling are thorough and well-placed.
Suggestions
Eliminate redundancy by keeping either the Quick Reference table or the Command Details section, not both — the table alone with a few advanced examples would cut the file nearly in half.
Add validation checkpoints to workflows: check media upload response for success/media_id before posting, verify post creation succeeded by reading it back, and add a note about checking `xurl media status --wait` before using video media IDs.
Consider splitting detailed command examples and raw API access into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with the quick reference table and common workflows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly well-organized but contains significant redundancy — the Quick Reference table duplicates nearly all the Command Details section, and many examples are repeated across sections (e.g., media upload workflow appears three times). Some notes at the end explain things Claude already knows (token refresh, rate limits). Could be tightened substantially. | 2 / 3 |
Actionability | Excellent actionability — every command is fully executable and copy-paste ready with concrete examples. Installation commands, auth setup, posting, reading, engagement, media upload, raw API access, and streaming all have specific, runnable CLI commands with clear argument patterns. | 3 / 3 |
Workflow Clarity | Common workflows are clearly sequenced (upload then post, read then reply), but there are no validation checkpoints or error recovery loops. For example, the media upload workflow doesn't check if upload succeeded before posting, and there's no guidance on handling rate limit errors beyond 'wait and retry'. The destructive operations (delete, unfollow, block) have no confirmation or verification steps. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and a useful quick reference table, but it's monolithic at ~300+ lines with no references to external files. The detailed command examples, global flags, streaming details, and notes could be split into separate reference files. However, since no bundle files are provided, the single-file approach is understandable though not ideal. | 2 / 3 |
Total | 9 / 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 | |
- Repository
- attilaczudor/Test
- Commit
b4fc4af
- 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.