CtrlK
BlogDocsLog inGet started
Tessl Logo

reminders

Apple Reminders via rem CLI: add, list, search, update, complete, delete.

68

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary lean, command-first reference: executable rem CLI examples, explicit read-after-write validation loops covering even destructive operations, and a valuable gotchas section for non-obvious tool behavior. Its only structural note is that it is a single ~97-line file with no progressive-disclosure layer, which is acceptable but keeps it just under the top anchor.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept explanations, just executable commands and genuinely non-obvious tool facts (permission requirements, localized default list names, --due creating an alarm). Every token earns its place, matching the anchor-5 example rather than anchor 4 (which implies trimmable over-explanation).

5 / 5

Actionability

Every section provides copy-paste-ready commands with real flags and a realistic worked example (rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" ...), plus the full flag reference and JSON output conventions. This fully matches anchor 5; anchor 4 would require minor gaps in executable coverage, which are absent.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (check access -> add -> verify -> find UUID -> mutate) with explicit validation feedback loops: "Default: add directly, then verify by search/show" and "Always read back after writes; do not trust exit status alone." Destructive operations are guarded ("Find the UUID first, then mutate"), satisfying anchor 5 including the destructive-operation cap.

5 / 5

Progressive Disclosure

The single-file structure is well organized with clear sections and nothing inlined that belongs in a separate file, and no bundle files exist. However, at ~97 lines it exceeds the under-50-line simple-skill exception for a score of 5, and there are no well-signaled references of the kind described in the anchor-5 example, so anchor 4 is the best fit.

4 / 5

Total

19

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, specific description that clearly states what the skill does via six concrete action verbs on a well-defined domain. Its main weakness is the complete absence of a "Use when..." trigger clause, which caps completeness and leaves trigger scoping implicit.

Suggestions

Append a trigger clause such as: 'Use when the user wants to manage reminders, todos, or to-do lists on macOS.'

Include natural synonyms like 'todo' or 'task list' so the description matches how users commonly refer to reminders.

Mention list management (creating, renaming, or deleting reminder lists) to round out the action coverage.

DimensionReasoningScore

Specificity

The description lists six concrete actions ("add, list, search, update, complete, delete") for a named domain, but coverage has minor gaps — e.g., list management (create/rename/delete lists) is supported by the body yet absent from the description. Anchor 4 (several specific actions, minor gaps) fits better than 5 (comprehensive) and clearly better than 3 (only 1-2 actions).

4 / 5

Completeness

The "what" is clear (Apple Reminders via rem CLI with six named operations), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. This is not 4 because the "when" is entirely absent rather than merely improvable, and not 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

"Apple Reminders" is the natural phrase users would say, giving good primary keyword coverage, but common synonyms and variations like "todo", "to-do list", or "tasks" are missing. This matches anchor 4 (good coverage, a few natural terms missing) rather than 5 (comprehensive synonyms) or 3 (missing common variations is more severe here).

4 / 5

Distinctiveness Conflict Risk

Naming the specific app ("Apple Reminders") and tool ("rem CLI") gives a clear niche with minimal conflict risk against unrelated skills, though it could still overlap with generic task/todo-management skills absent any "when" scoping. Anchor 4 (mostly distinct, minor overlap) fits better than 5 and clearly better than 3.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
steipete/agent-scripts
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.