Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
81
76%
Does it follow best practices?
Impact
96%
1.71xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/apple-reminders/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is concise and specific about capabilities, clearly naming the tool (remindctl), the platform (Apple Reminders), and the supported actions. Its main weaknesses are the lack of an explicit 'Use when...' clause and missing natural user trigger terms like 'todo', 'tasks', or 'reminder app' that would help Claude match this skill to user requests.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to manage Apple Reminders, create todos, check tasks, or interact with the macOS Reminders app.'
Include natural trigger terms users would say, such as 'todo', 'tasks', 'reminder app', 'to-do list', 'macOS reminders', or 'remind me'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: list, add, edit, complete, delete. Also mentions specific features like lists, date filters, and output formats (JSON/plain). | 3 / 3 |
Completeness | Clearly answers 'what does this do' with specific actions and features, but lacks an explicit 'Use when...' clause or equivalent trigger guidance, which caps this at 2 per the rubric. | 2 / 3 |
Trigger Term Quality | Includes relevant terms like 'Apple Reminders', 'remindctl', and action verbs, but misses natural user phrases like 'todo', 'tasks', 'reminder app', 'to-do list', or 'macOS reminders' that users would commonly say. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche — specifically targets Apple Reminders via the remindctl CLI tool. Unlikely to conflict with other skills due to the specific tool name and platform. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted CLI reference skill with excellent actionability—every command is concrete and executable. The 'When to Use / When NOT to Use' disambiguation section is a thoughtful addition for a tool that could be confused with other reminder/alert mechanisms, though it could be slightly more concise. Overall structure is clean and easy to navigate.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'When to Use' and 'When NOT to Use' sections add useful disambiguation but are somewhat verbose. The clarifying intent example at the bottom is helpful but could be tighter. The core command reference is lean and efficient. | 2 / 3 |
Actionability | Every command is concrete, copy-paste ready, and covers the full range of operations (view, create, manage lists, complete, delete, output formats). Setup instructions are specific with exact brew install command. | 3 / 3 |
Workflow Clarity | This is a single-task CLI reference skill where each command is self-contained and non-destructive (reminders can be uncompleted/re-added). The commands are clearly categorized and sequenced logically from viewing to creating to completing. The --force flag on delete is appropriately shown. | 3 / 3 |
Progressive Disclosure | Content is well-organized into logical sections (setup, view, lists, create, complete, output formats, date formats) with clear headers. For a CLI reference skill of this size, no external files are needed and the structure supports easy scanning. | 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 | |
af8bd5f
Table of Contents
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.