CtrlK
BlogDocsLog inGet started
Tessl Logo

apple-reminders

Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

81

1.71x
Quality

76%

Does it follow best practices?

Impact

96%

1.71x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/apple-reminders/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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-structured CLI reference skill with excellent actionability — every command is concrete and executable. The disambiguation sections (When to Use / When NOT to Use) add genuine value for routing user intent correctly, though they could be slightly more concise. Overall, this is a strong skill that efficiently teaches Claude how to manage Apple Reminders via the CLI.

DimensionReasoningScore

Conciseness

The 'When to Use' and 'When NOT to Use' sections add useful disambiguation but are somewhat verbose. The example clarifying user intent at the end is helpful but could be more compact. Some bullet points in the 'When NOT to Use' section explain things Claude would already know (e.g., what Calendar events are).

2 / 3

Actionability

Every command is concrete, copy-paste ready, and covers the full range of operations (view, create, complete, delete, list management, output formats). Setup instructions are specific with exact brew install command and authorization steps.

3 / 3

Workflow Clarity

This is a single-purpose CLI reference skill, not a multi-step destructive workflow. The commands are clearly categorized and sequenced logically (setup → view → manage lists → create → complete/delete → output formats). The disambiguation workflow at the end provides a clear decision tree for ambiguous requests.

3 / 3

Progressive Disclosure

For a standalone skill with no bundle files, the content is well-organized into clearly labeled sections with appropriate depth. Each section is scannable and self-contained. The skill doesn't need external references given its scope, and the structure supports quick lookup.

3 / 3

Total

11

/

12

Passed

Description

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), the platform (Apple Reminders), and concrete actions. However, it lacks an explicit 'Use when...' clause and could benefit from more natural user-facing trigger terms like 'todo', 'tasks', or 'reminder app' to improve discoverability.

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', or 'macOS reminders'.

DimensionReasoningScore

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 for when Claude should select this skill.

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 — 'Apple Reminders' and 'remindctl CLI' are highly specific identifiers that are unlikely to conflict with other skills.

3 / 3

Total

10

/

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.

Validation8 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
attilaczudor/Test
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.