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 ./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), platform (Apple Reminders), and supported actions. Its main weakness is the absence of an explicit 'Use when...' clause and missing natural user trigger terms like 'todo', 'tasks', or 'reminder app' that would help Claude select this skill from user requests phrased in everyday language.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user asks about Apple Reminders, todos, tasks, or managing reminders on macOS.'
Include natural trigger terms users would say, such as 'todo', 'tasks', 'reminder app', 'to-do list', 'macOS reminders'.
| 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 that provides concrete, executable commands organized into clear categories. The 'When to Use / When NOT to Use' disambiguation section is a strong addition for routing intent correctly, though it could be slightly more concise. The skill effectively assumes Claude's competence while providing all the tool-specific knowledge needed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'When to Use' and 'When NOT to Use' sections add useful disambiguation but are somewhat verbose. The clarification example at the end 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, complete, delete, list management). Setup instructions are specific with exact brew install command and authorization steps. | 3 / 3 |
Workflow Clarity | This is a simple CLI tool skill where each command is a single action, not a multi-step destructive workflow. The commands are clearly categorized and sequenced logically (setup → view → manage lists → create → complete/delete → output formats). The intent clarification example adds a useful decision checkpoint. | 3 / 3 |
Progressive Disclosure | For a skill of this scope (single CLI tool, under 100 lines), the content is well-organized into logical sections with clear headers. No external references are needed, and the structure allows quick scanning to find the relevant command category. | 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 | |
b3cef5f
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.