CtrlK
BlogDocsLog inGet started
Tessl Logo

notion-automation

Automate Notion tasks via Rube MCP (Composio): pages, databases, blocks, comments, users. Always search tools first for current schemas.

67

2.08x
Quality

51%

Does it follow best practices?

Impact

98%

2.08x

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/notion-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 (Notion automation via a specific MCP integration) and lists relevant entity types, giving it good distinctiveness. However, it lacks specific action verbs describing what can be done, omits a 'Use when...' clause entirely, and includes technical jargon (Rube MCP, Composio) that users wouldn't naturally use as trigger terms.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to create, update, query, or manage Notion pages, databases, blocks, comments, or users.'

Replace the vague 'Automate Notion tasks' with specific concrete actions such as 'Create and update Notion pages, query databases, manage blocks, add comments, and look up users.'

Include natural user-facing trigger terms like 'Notion page', 'Notion database', 'add to Notion', 'update Notion' rather than relying on internal tool names like 'Rube MCP (Composio)'.

DimensionReasoningScore

Specificity

It names the domain (Notion) and lists entity types (pages, databases, blocks, comments, users) but doesn't describe specific concrete actions beyond 'automate tasks'. What actions? Create, update, delete, query? The instruction to 'search tools first' is a procedural hint, not a capability description.

2 / 3

Completeness

It partially answers 'what' (automate Notion tasks) but there is no explicit 'Use when...' clause or equivalent trigger guidance. The rubric states a missing 'Use when...' clause should cap completeness at 2, and the 'what' itself is also vague ('automate tasks'), so this falls to 1.

1 / 3

Trigger Term Quality

Includes 'Notion', 'pages', 'databases', 'blocks', 'comments', 'users' which are relevant keywords. However, it misses natural user phrases like 'create a Notion page', 'query a database', 'add a comment in Notion', and the mention of 'Rube MCP (Composio)' is technical jargon users wouldn't naturally say.

2 / 3

Distinctiveness Conflict Risk

The description is clearly scoped to Notion via a specific integration (Rube MCP / Composio), making it highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

8

/

12

Passed

Implementation

62%

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 skill for Notion automation via Rube MCP with well-structured workflows, clear tool sequencing, and useful pitfall documentation. Its main weaknesses are moderate verbosity with some redundancy between sections (workflows vs. quick reference table, repeated pagination warnings) and a lack of fully executable examples showing complete MCP tool calls with all parameters. The monolithic structure could benefit from splitting detailed content into separate reference files.

Suggestions

Add at least one fully executable MCP tool call example per core workflow showing the complete parameter structure (e.g., a full RUBE_SEARCH_TOOLS call followed by a NOTION_CREATE_NOTION_PAGE call with all required parameters filled in).

Remove the quick reference table or consolidate it with the workflow sections to eliminate redundancy and save tokens.

Extract repeated guidance (pagination pattern, ID resolution, filter syntax) into a single 'Common Patterns' section and remove duplicated warnings from individual workflow pitfall lists.

DimensionReasoningScore

Conciseness

The skill is fairly well-organized but is quite long (~200 lines) with some redundancy. Pitfalls are repeated across sections (e.g., pagination warnings appear in multiple workflows and again in Common Patterns). The quick reference table at the end largely duplicates information already covered in the workflow sections. Some trimming would improve token efficiency.

2 / 3

Actionability

The skill provides concrete tool names, parameter names, and JSON filter examples, which is good. However, it lacks fully executable call examples showing actual MCP tool invocations with complete parameter structures. The 'Common Patterns' section uses pseudocode-style numbered steps rather than concrete executable examples. The filter syntax examples are a strong point but are the exception rather than the rule.

2 / 3

Workflow Clarity

Each workflow has a clear numbered sequence with labeled steps (Prerequisite, Required, Optional), explicit tool ordering, and pitfall sections that serve as validation guidance. The pagination pattern includes a clear feedback loop (continue until has_more is false). The setup section has an explicit checkpoint (confirm ACTIVE status before proceeding). Error conditions and their causes are well-documented.

3 / 3

Progressive Disclosure

The content is well-structured with clear sections and a useful quick reference table, but it's a monolithic document with no bundle files or references to separate detailed guides. The database schema management, block management, and filter syntax sections could be split into separate reference files. The single external link to Composio docs is helpful but the skill itself could benefit from splitting its ~200 lines of content.

2 / 3

Total

9

/

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.