CtrlK
BlogDocsLog inGet started
Tessl Logo

things-todo

Things 3 via things CLI: add, list, search, update, delete, verify.

69

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The body is a tight, executable reference: concise sections, concrete commands, and explicit write-then-read-back feedback loops for mutations. It is well-organized for a self-contained single-purpose skill with no need for external references.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what Things 3 or a to-do is, and every line is a command, flag, or actionable convention, matching the lean/efficient anchor.

3 / 3

Actionability

Commands like 'things add "..." --notes "..." --when tomorrow --tags travel' and the install/auth snippets are concrete and copy-paste ready, with placeholders only where a runtime value is genuinely needed.

3 / 3

Workflow Clarity

Sequences are explicit with validation checkpoints — 'add, then search/read back', 'Find the UUID first, then mutate by id', and 'Always read back after writes' — providing the feedback loops the rubric rewards for destructive/batch operations.

3 / 3

Progressive Disclosure

A single-purpose CLI skill with no bundle files, organized into clearly headed sections (Tool, Start, Add, Update/Delete, Conventions, Gotchas) that give easy navigation with no nested references, fitting the well-organized simple-skill case.

3 / 3

Total

12

/

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 specific and well-differentiated, naming both the app and CLI plus a full set of CRUD+verify actions. Its main weakness is the absence of an explicit 'when to use' trigger, which caps completeness, and limited noun-term variations.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when managing Things 3 to-dos/tasks on Peter's Macs.'

Include natural noun variations users say, such as 'todos', 'tasks', or 'to-dos', alongside 'Things 3'.

Optionally surface the disambiguation against Apple Reminders so Claude picks this skill only for Things-backed items.

DimensionReasoningScore

Specificity

The phrase 'add, list, search, update, delete, verify' lists multiple concrete actions scoped to a named tool, matching the anchor for listing several specific actions rather than just naming a domain.

3 / 3

Completeness

It clearly states what the skill does but lacks an explicit 'Use when...' trigger clause, so the 'when' is only implied and is capped at 2 per the judging guidelines.

2 / 3

Trigger Term Quality

'Things 3' and 'things CLI' are natural user terms, but common noun variations users would say ('todo', 'task', 'to-do') are absent, so coverage is partial rather than comprehensive.

2 / 3

Distinctiveness Conflict Risk

Naming the specific product 'Things 3' and its 'things CLI' carves out a clear niche unlikely to trigger for unrelated skills, matching the distinct-triggers anchor.

3 / 3

Total

10

/

12

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.

Validation16 / 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.