Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with executable commands, clear workflows, and a genuine feedback checkpoint for media processing, plus excellent secret-safety guidance. Its weaknesses are the duplicated command catalog (Quick Reference table vs. Command Details) and a monolithic single-file structure with no progressive disclosure into reference files.
Suggestions
De-duplicate the Quick Reference table and the Command Details sections — keep the compact table as the index and move the per-category examples into a single detailed section or reference file instead of restating every command.
Split the full command catalog, global flags, raw API, and streaming sections into references/ files (e.g., commands.md, raw-api.md) linked one level deep from SKILL.md, keeping the body as a concise overview.
Add a pre-verification step before destructive operations (e.g., 'xurl read POST_ID' to confirm the target before 'xurl delete POST_ID', and check auth with 'xurl auth status' before batch writes).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids concept explanations and is mostly tables and command blocks, but the Quick Reference table is restated nearly command-for-command in 'Command Details' (e.g., 'xurl post "Hello world!"' appears in both), which is more than the 'minor instances' tolerated at 4. | 3 / 5 |
Actionability | Every command is copy-paste ready and executable, with concrete flag usage, JSON output and error shapes shown, and workflows that spell out placeholder substitution (e.g., 'xurl post "Check this out" --media-id MEDIA_ID'), fully covering common cases per the 5 anchor. | 5 / 5 |
Workflow Clarity | Multi-step workflows are clearly numbered ("1. Upload the image / 2. Copy the media_id from the response, then post") with an explicit validation checkpoint ('xurl media status --wait' polls until done) and error feedback (non-zero exit codes, JSON errors, re-auth guidance), but destructive commands (delete, block, unfollow) lack any pre-verification step, preventing a 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the entire reference — full command catalog, global flags, raw API mode, streaming, and notes — is inlined in a single ~430-line SKILL.md; section headers provide structure, but content that clearly belongs in separate reference files is inline, which is the anchor-3 pattern rather than 2 (structure is good, not minimal). | 3 / 5 |
Total | 15 / 20 Passed |