things-mac
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
Install with Tessl CLI
npx tessl i github:Hung-Reo/hungreo-openclaw --skill things-mac92
Does it follow best practices?
Validation for skill structure
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 clearly specifies the tool (Things 3 via CLI on macOS), lists concrete actions (add/update/read/search), and provides explicit trigger guidance with natural user language. The description is distinctive enough to avoid conflicts with other task management or productivity skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'add/update projects+todos via URL scheme', 'read/search/list from the local Things database'. Clearly describes the technical mechanism and specific operations. | 3 / 3 |
Completeness | Clearly answers both what (manage Things 3 via CLI, add/update/read/search) AND when with explicit 'Use when' clause listing specific trigger scenarios like adding tasks, listing inbox/today/upcoming, searching, and inspecting. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'add a task to Things', 'list inbox/today/upcoming', 'search tasks', 'inspect projects/areas/tags'. These are terms users naturally use when working with task management. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche: specifically targets 'Things 3' app on macOS via the 'things' CLI. The app name, platform, and specific features (inbox/today/upcoming, projects/areas/tags) make it unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
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 efficiently documents the things CLI with concrete, executable examples. The content is well-organized and assumes Claude's competence. Minor improvement could be made by integrating --dry-run more explicitly into workflows for destructive operations like update --completed.
Suggestions
Consider adding an explicit workflow pattern for updates: 'Always preview with --dry-run before executing update commands that complete/cancel todos'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what Things 3 is or how CLI tools work. Every line provides actionable information Claude needs. | 3 / 3 |
Actionability | Fully executable commands throughout with specific flags and real examples. Copy-paste ready commands for all operations including add, update, search, and various options. | 3 / 3 |
Workflow Clarity | Steps are clear for individual operations, but the update workflow (search for ID -> get token -> update) could benefit from explicit validation. The --dry-run is mentioned but not integrated into a clear 'always preview first' workflow pattern. | 2 / 3 |
Progressive Disclosure | Well-organized with clear sections (Setup, Read-only, Write, Examples). For a skill of this size (~60 lines), the structure is appropriate with no need for external files. Easy to scan and find relevant commands. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 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 |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- 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.