Content
87%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 that provides comprehensive, actionable CLI reference for Things 3 management. It's concise, well-structured, and covers both read and write operations with concrete examples. The only notable gap is the lack of explicit verification/validation steps after write operations, which would strengthen the workflow for destructive or state-changing commands.
Suggestions
Add a verification step after write operations, e.g., 'After updating, confirm with `things search "<title>" --limit 1` to verify the change took effect.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It assumes Claude knows what a URL scheme is, what UUIDs are, and how CLI tools work. Every section delivers actionable information without preamble or unnecessary explanation. | 3 / 3 |
Actionability | Every operation has concrete, copy-paste-ready commands with real flag names and realistic example values. The examples cover basic through advanced use cases (add, update, search, checklist items, STDIN input) with specific flags and arguments. | 3 / 3 |
Workflow Clarity | The modify workflow correctly sequences steps (search for ID → set auth → update), and dry-run is mentioned for safe preview. However, there are no explicit validation checkpoints or error-recovery feedback loops for write operations—e.g., no 'verify the update succeeded by re-searching' step after mutations. | 2 / 3 |
Progressive Disclosure | For a standalone skill with no bundle files, the content is well-organized into logical sections (Setup, Read, Write, Examples, Notes) with clear headers. The skill is under 80 lines and doesn't need external references; the flat structure is appropriate and easy to navigate. | 3 / 3 |
Total | 11 / 12 Passed |