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 strong on specificity and distinctiveness, clearly naming the tool (remindctl), platform (Apple Reminders), and supported operations. However, it lacks an explicit 'Use when...' clause which caps completeness, and could benefit from more natural trigger terms that users would actually say (e.g., 'todo', 'tasks', 'reminder app').
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user asks about managing reminders, todos, or tasks on macOS, or mentions Apple Reminders or remindctl.'
Include natural user-facing trigger terms like 'todo', 'tasks', 'to-do list', 'macOS reminders', 'reminder app' to improve matching against common user phrasing.
| 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' (manage Apple Reminders via remindctl CLI with specific actions), but lacks an explicit 'Use when...' clause specifying when Claude should select this skill. | 2 / 3 |
Trigger Term Quality | Includes relevant terms like 'Apple Reminders', 'remindctl', and action verbs (list, add, edit, complete, delete), but misses natural user phrases like 'todo', 'tasks', 'to-do list', 'reminder app', 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 sections. The disambiguation sections (When to Use / When NOT to Use) add genuine value for routing user intent correctly. Minor verbosity in the preamble sections prevents a perfect conciseness score, but overall the skill is highly actionable and well-structured.
| 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 more compact. The core command reference is lean and efficient. | 2 / 3 |
Actionability | Every section provides concrete, copy-paste-ready commands with clear examples. Setup instructions are specific (brew install path), commands cover all major operations with real arguments and flags, and date formats are explicitly enumerated. | 3 / 3 |
Workflow Clarity | For a CLI reference skill, the workflow is appropriately clear: setup → view → manage lists → create → complete/delete. The intent clarification example provides a useful decision tree. No destructive batch operations require feedback loops beyond what's shown (--force flag for delete). | 3 / 3 |
Progressive Disclosure | For a self-contained CLI reference skill under 80 lines with no need for external references, the content is well-organized into logical sections with clear headers. No bundle files are needed and none are referenced, which is appropriate. | 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 | |
b4fc4af
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.