CtrlK
BlogDocsLog inGet started
Tessl Logo

task-management

Manage Joel's task system in Todoist. Triggers on: 'add a task', 'create a todo', 'what's on my list', 'today's tasks', 'what do I need to do', 'remind me to', 'inbox', 'complete', 'mark done', 'weekly review', 'groom tasks', 'what's next', or when actionable items emerge from other work. Also triggers when Joel mentions something he needs to do in passing — capture it.

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/task-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

A highly actionable, well-structured operational skill whose CLI reference, tables, and concrete examples leave no ambiguity about what to run. Its weaknesses are redundancy (the agent-does-it rule appears four times), philosophy exposition Claude doesn't need, and a monolithic ~270-line body that inlines reference material (full CLI syntax, filter queries) a references/ file could hold.

Suggestions

Collapse the 'could the agent just do this' guidance, which currently appears in 'Personal action boundary', the 'Could the agent just do this?' section, the ADR SOP, and 'Anti-Patterns', into one authoritative section and reference it elsewhere; trim the GTD/Shape Up/Tiny Habits summaries to the one-line operational rule each contributes.

Move the full CLI command reference, priority/schedule/structure tables, and Todoist filter syntax into a references/ file (e.g. references/cli-reference.md) and keep SKILL.md as an overview with clearly signaled links, per progressive-disclosure best practice.

Add an explicit verification step before destructive operations (e.g. confirm delete/kill decisions with Joel, or verify the task was created with todoist-cli show after add) to close the workflow-clarity validation gap.

DimensionReasoningScore

Conciseness

Mostly operational and tight (command blocks, tables, rules), but the GTD/Shape Up/Tiny Habits philosophy summaries re-explain frameworks Claude already knows, and the 'could the agent just do this' rule is restated in four separate sections (Personal action boundary, 'Could the agent just do this?', the ADR SOP, and Anti-Patterns). This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 2 because most sections are concrete rather than padded, and not 4 because the redundancy and philosophy exposition are more than minor.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready todoist-cli commands for read/write/add/complete/move/delete, a UI-vs-API priority table with agent rules, schedule and structure mappings, filter query examples, and concrete good/bad task examples. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The inbox triage, weekly review, and ADR-to-tasks workflows are clearly sequenced numbered steps with concrete commands, and the batch triage includes a checkpoint ('Present as a batch decision') with an auth-failure fallback. It is not 5 because destructive operations (delete, kill zombie projects) lack an explicit verify-before-acting or error-recovery step, and not 3 because the batch-decision presentation and fallback constitute present checkpoints rather than missing ones.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers but is a ~270-line single file: the full CLI command reference, priority/schedule/structure tables, and Todoist filter syntax are inline material that would fit naturally in references/ files, and no bundle files exist (only logo assets). This matches 'Some structure but could be better organized... content that should be separate is inline'; it is not 2 because headers and navigation within the file are good, and not 4 because there is no split of reference-heavy material out of the main file.

3 / 5

Total

15

/

20

Passed

Description

77%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 strong description with excellent, natural trigger coverage and explicit when-to-use guidance in third-person voice. Its main weakness is a vague 'what' — 'Manage Joel's task system' tells the domain but not the concrete operations (capture, schedule, complete, triage, review).

Suggestions

Replace the generic 'Manage Joel's task system in Todoist' with concrete operations, e.g. 'Capture, schedule, triage, complete, and review personal tasks in Todoist (add tasks, process inbox to zero, run weekly review, set p1-p4 priorities).' This would raise both specificity and completeness.

Qualify the ambiguous bare-word triggers ('complete', 'inbox', 'what's next') with task context, e.g. 'complete a task', 'check my inbox', to reduce overlap risk with code, email, or other skills.

DimensionReasoningScore

Specificity

The description names the domain ("Manage Joel's task system in Todoist") but relies on a single generic verb ('Manage') rather than enumerating concrete actions like add, complete, schedule, or triage. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is not 4 because no list of specific operations is given, and not 2 because the domain is precisely named rather than minimal.

3 / 5

Completeness

Both parts are present: 'Manage Joel's task system in Todoist' answers what, and 'Triggers on: ...' with a dozen concrete phrases plus 'Also triggers when Joel mentions something he needs to do in passing' answers when explicitly. It is not 5 because the 'what' is a single generic verb rather than the concrete action enumeration in the anchor example, and not 3 because the 'when' clause is fully explicit, avoiding the missing-trigger cap.

4 / 5

Trigger Term Quality

Phrases like 'add a task', 'create a todo', 'what's on my list', 'today's tasks', 'remind me to', 'mark done', 'what's next', and 'weekly review' are exactly what a user would naturally say, covering synonyms and variations. This matches the 'Comprehensive coverage of natural terms including synonyms' anchor; neither the 4 nor any lower anchor covers this breadth.

5 / 5

Distinctiveness Conflict Risk

The Todoist anchor and task-specific phrases give it a clear niche, but generic single-word triggers like 'complete', 'inbox', and 'what's next' could fire in unrelated contexts (code completion, email inbox). This matches 'Mostly distinct; minor overlap risk'; it is not 5 because of those ambiguous bare-word triggers, and not 3 because the tool-specific framing dominates.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
joelhooks/joelclaw
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.