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 and comprehensive coverage of the xurl CLI tool. Its main weaknesses are redundancy between the quick reference and detailed sections, a monolithic structure that could benefit from splitting into referenced sub-files, and missing validation/verification steps in multi-step workflows. The security constraints around credential handling are thorough and well-articulated.
Suggestions
Remove the Command Details section's duplication with Quick Reference by keeping the table as the overview and moving detailed examples to a separate COMMANDS.md reference file.
Add verification steps to workflows — e.g., after 'xurl media upload', check the response for media_id before proceeding; after posting, read the post back to confirm success.
Move Installation, Streaming, Global Flags, and Notes sections to a separate REFERENCE.md file, keeping the main skill focused on authentication setup, quick reference, and common workflows.
Trim the Notes section — remove explanations of concepts like rate limits and token refresh that Claude already understands, keeping only xurl-specific behavioral notes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly comprehensive but includes some redundancy — the Quick Reference table and Command Details sections largely duplicate each other. The Notes section contains some information Claude would already know (e.g., explaining what rate limits are). Installation instructions are also verbose for a skill that should focus on usage. However, the content is generally well-structured and not padded with unnecessary conceptual explanations. | 2 / 3 |
Actionability | Excellent actionability throughout — every command is copy-paste ready with concrete examples, real flags, and specific syntax. The raw API access section, media upload workflow, and multi-app setup all provide fully executable commands with clear expected behavior. | 3 / 3 |
Workflow Clarity | Common Workflows section provides clear multi-step sequences (post with image, reply to conversation, search and engage), but lacks validation checkpoints. For example, the media upload workflow doesn't check if the upload succeeded before posting, and there's no guidance on verifying a post was created successfully. The error handling section exists but isn't integrated into the workflows as feedback loops. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and a useful quick reference table, but it's monolithic — everything is in one large file (~300+ lines). The detailed command examples, streaming docs, global flags, and notes could be split into separate reference files with links from the main skill. No external file references are used for progressive disclosure. | 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
- trpc-group/trpc-agent-go
- Commit
09cce3e
- 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.