CtrlK
BlogDocsLog inGet started
Tessl Logo

clickup-automation

Automate ClickUp project management including tasks, spaces, folders, lists, comments, and team operations via Rube MCP (Composio). Always search tools first for current schemas.

71

1.67x
Quality

58%

Does it follow best practices?

Impact

92%

1.67x

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/clickup-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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 does a good job specifying the platform (ClickUp) and listing concrete entity types it can manage, making it distinctive. However, it lacks an explicit 'Use when...' clause, which is critical for Claude to know when to select this skill. The trigger terms lean slightly technical and could benefit from more natural user language.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about ClickUp tasks, project management in ClickUp, or managing ClickUp workspaces.'

Include more natural user-facing trigger terms like 'project tracking', 'assign tasks', 'due dates', 'task status', or 'ClickUp boards' to improve keyword coverage.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: tasks, spaces, folders, lists, comments, and team operations. Also specifies the platform (ClickUp) and the integration method (Rube MCP/Composio), plus an operational instruction to search tools first.

3 / 3

Completeness

The 'what' is well covered (automate ClickUp project management across multiple entity types), but there is no explicit 'Use when...' clause or equivalent trigger guidance telling Claude when to select this skill. This caps completeness at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes good keywords like 'ClickUp', 'tasks', 'spaces', 'folders', 'lists', 'comments', and 'team operations', but misses common user variations like 'project tracking', 'task management', 'assign tasks', 'due dates', 'sprints', or 'boards'. The terms 'Rube MCP' and 'Composio' are technical jargon unlikely to be used by end users.

2 / 3

Distinctiveness Conflict Risk

The description is clearly scoped to ClickUp specifically, with distinct entity types (spaces, folders, lists) that are unique to ClickUp's data model. It is unlikely to conflict with other project management tool skills due to the explicit platform naming.

3 / 3

Total

10

/

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 skill provides comprehensive coverage of ClickUp automation via Rube MCP with well-organized workflow sections and useful pitfall documentation. Its main weaknesses are significant content repetition (especially around timestamps, case-sensitivity, and team_id semantics), lack of concrete executable examples showing actual tool calls with sample parameters and responses, and missing validation/error-recovery steps in workflows. The skill would benefit from deduplication, concrete examples, and explicit verification checkpoints.

Suggestions

Add at least one concrete end-to-end example showing actual tool calls with sample input parameters and expected response structures (e.g., creating a task from workspace name to task ID confirmation).

Deduplicate repeated pitfalls (millisecond timestamps, case-sensitive statuses, team_id = workspace ID) by consolidating them in the 'Known Pitfalls' section and removing duplicates from individual workflow sections.

Add explicit validation checkpoints to workflows, such as verifying task creation succeeded by checking the returned task ID, and add error recovery guidance for common failures like 429 rate limits or invalid status names.

Consider splitting the detailed parameter references and quick reference table into a separate REFERENCE.md file to reduce the main skill's length and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is quite long (~200+ lines) with significant repetition. Pitfalls about millisecond timestamps, case-sensitive statuses, and team_id meaning workspace ID are repeated across multiple sections and again in the 'Known Pitfalls' summary. The quick reference table largely duplicates information already covered in the workflow sections. However, the content is mostly factual and avoids explaining basic concepts Claude would know.

2 / 3

Actionability

The skill provides clear tool names, parameter lists, and sequences, which is good. However, there are no executable code examples or concrete input/output demonstrations — everything is described abstractly (tool names and parameter names). A concrete example showing an actual RUBE_SEARCH_TOOLS call with sample input/output or a complete task creation flow with real parameter values would significantly improve actionability.

2 / 3

Workflow Clarity

Multi-step 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 creating a task, there's no step to verify it was created successfully, and there's no guidance on handling 429 rate limit errors beyond 'honor Retry-After header.' The duplicate-creation pitfall is mentioned but no concrete prevention mechanism is provided.

2 / 3

Progressive Disclosure

The content is a monolithic document with no references to supporting files, which is understandable given no bundle files exist. The internal organization with sections and a quick reference table is reasonable, but the document is quite long and would benefit from splitting detailed parameter references and pitfalls into separate files. The repetition between workflow-specific pitfalls and the consolidated 'Known Pitfalls' section suggests content that should be deduplicated or restructured.

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.