CtrlK
BlogDocsLog inGet started
Tessl Logo

todoist-automation

Automate Todoist task management, projects, sections, filtering, and bulk operations via Rube MCP (Composio). Always search tools first for current schemas.

62

1.56x
Quality

45%

Does it follow best practices?

Impact

94%

1.56x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/todoist-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 identifies a clear niche (Todoist via Rube MCP/Composio) and lists some capability areas, but lacks concrete action verbs and an explicit 'Use when...' clause. The instruction to 'always search tools first for current schemas' is an implementation detail that doesn't help with skill selection. Adding explicit trigger guidance and more specific actions would significantly improve this description.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Todoist tasks, to-do lists, task scheduling, or managing projects in Todoist.'

Replace category nouns with concrete action verbs, e.g., 'Create, update, and delete Todoist tasks; organize projects and sections; filter tasks by label, priority, or due date; perform bulk operations like completing or moving multiple tasks.'

Move the implementation detail ('Always search tools first for current schemas') into the skill body rather than the description, as it doesn't help Claude decide when to select this skill.

DimensionReasoningScore

Specificity

Names the domain (Todoist task management) and lists several actions (projects, sections, filtering, bulk operations), but these are more like categories than concrete specific actions. It doesn't detail what specific operations are performed (e.g., 'create tasks', 'move tasks between projects', 'set due dates').

2 / 3

Completeness

Describes what it does (automate Todoist task management) but has no explicit 'Use when...' clause or equivalent trigger guidance. The rubric states a missing 'Use when...' clause should cap completeness at 2, and since the 'when' is entirely absent and the 'what' is only moderately detailed, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Todoist', 'task management', 'projects', 'sections', 'filtering', and 'bulk operations', which are natural terms. However, it misses common variations users might say like 'to-do list', 'tasks', 'due dates', 'reminders', 'labels', or 'priorities'.

2 / 3

Distinctiveness Conflict Risk

The description is clearly scoped to Todoist specifically via Rube MCP (Composio), which creates a very distinct niche. It's unlikely to conflict with other skills unless there's another Todoist-specific skill.

3 / 3

Total

8

/

12

Passed

Implementation

50%

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

This is a solid reference-style skill that covers Todoist operations comprehensively with good structural organization and useful pitfall documentation. Its main weaknesses are redundancy across sections (pitfalls and parameter details repeated), lack of concrete executable examples showing actual MCP tool call payloads, and missing validation/verification steps for destructive operations. The content would benefit from deduplication, adding example tool invocations, and splitting reference material into bundle files.

Suggestions

Add concrete example MCP tool call payloads (input JSON) for at least the most common operations (create task, bulk create, filter tasks) to improve actionability.

Add explicit validation steps after destructive operations (DELETE_TASK, DELETE_SECTION) and bulk operations (BULK_CREATE_TASKS) — e.g., 'Verify by calling GET_ALL_TASKS to confirm creation' — to improve workflow clarity.

Deduplicate repeated content: consolidate priority inversion, due date handling, and ID format notes into the 'Known Pitfalls' and 'Common Patterns' sections only, removing them from individual workflow sections.

Consider splitting the Quick Reference table and Known Pitfalls into separate bundle files (e.g., REFERENCE.md, PITFALLS.md) to keep the main SKILL.md focused on workflows and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some redundancy — pitfalls are repeated across sections (e.g., priority inversion appears in both 'Create and Manage Tasks' and 'Known Pitfalls'; due date handling is explained in both workflow 1 and 'Common Patterns'). The quick reference table at the end largely duplicates information already covered in the workflows. However, it avoids explaining basic concepts Claude already knows and stays focused on Todoist-specific details.

2 / 3

Actionability

The skill provides specific tool names, parameter names, and filter syntax examples, which is good. However, it lacks executable code or concrete MCP call examples showing exact input/output JSON. The guidance is detailed but remains at the 'describe the parameters' level rather than providing copy-paste-ready tool invocations with example payloads.

2 / 3

Workflow Clarity

Workflows are clearly sequenced with numbered steps and labeled as Required/Optional/Prerequisite, which is helpful. However, there are no explicit validation checkpoints or error recovery feedback loops — for example, after bulk task creation there's no step to verify tasks were created correctly, and destructive operations like DELETE_TASK and DELETE_SECTION lack confirmation/verification steps.

2 / 3

Progressive Disclosure

The content is well-organized with clear section headers and a logical progression from setup to workflows to common patterns. However, at ~200+ lines it's a monolithic document with no bundle files to offload detailed reference material. The quick reference table, detailed pitfalls, and common patterns sections could be split into separate files to keep the main skill leaner.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
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.