CtrlK
BlogDocsLog inGet started
Tessl Logo

amplitude-automation

Automate Amplitude tasks via Rube MCP (Composio): events, user activity, cohorts, user identification. Always search tools first for current schemas.

70

1.23x
Quality

60%

Does it follow best practices?

Impact

83%

1.23x

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

Quality

Discovery

57%

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 (Amplitude automation via Composio) and lists relevant task categories, making it distinctive. However, it lacks a 'Use when...' clause, the listed capabilities are more like topic labels than concrete actions, and it could benefit from more natural trigger terms users might use when requesting analytics tasks.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Amplitude analytics, tracking events, querying user activity, or managing cohorts.'

Make capabilities more concrete by specifying actions, e.g., 'Query event data, look up user activity, create and manage cohorts, identify users' instead of just listing nouns.

Include additional natural trigger terms like 'analytics', 'tracking', 'funnel analysis', or 'Amplitude API' to improve keyword coverage.

DimensionReasoningScore

Specificity

Names the domain (Amplitude via Rube MCP/Composio) and lists some actions (events, user activity, cohorts, user identification), but these are more like category labels than concrete actions. It doesn't specify what it does with events or cohorts (create, query, delete?).

2 / 3

Completeness

The 'what' is partially addressed (automate Amplitude tasks), but there is no explicit 'Use when...' clause or equivalent trigger guidance. The instruction to 'always search tools first' is operational guidance rather than a trigger condition. Per rubric, missing 'Use when' caps completeness at 2.

2 / 3

Trigger Term Quality

Includes relevant keywords like 'Amplitude', 'events', 'user activity', 'cohorts', and 'user identification', which are natural terms. However, it misses common variations users might say like 'analytics', 'tracking', 'funnel', 'retention', or 'Amplitude API'.

2 / 3

Distinctiveness Conflict Risk

The description is quite specific to Amplitude via Rube MCP (Composio), which is a distinct niche. It's unlikely to conflict with other skills given the specific tool and platform references.

3 / 3

Total

9

/

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 competent integration skill with clear workflow sequencing and good coverage of Amplitude operations via Rube MCP. Its main weaknesses are significant content repetition (especially around user ID resolution and pitfalls) that inflates token cost, and a lack of fully executable tool call examples that would make it immediately actionable. The structure is logical but the document is longer than necessary due to redundancy.

Suggestions

Consolidate repeated pitfalls (user ID resolution, timestamps, rate limits) into a single 'Known Pitfalls' section and remove duplicates from individual workflow sections to reduce token cost by ~30%.

Add at least one fully executable tool call example per core workflow showing the complete parameter structure (not pseudocode steps), e.g., a complete RUBE_SEARCH_TOOLS call followed by AMPLITUDE_SEND_EVENTS with all required fields.

Consider splitting detailed parameter documentation and pitfalls into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with workflow sequences and quick reference table.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but contains significant repetition—pitfalls about user_id vs internal ID are stated in workflows 2, 3, the Common Patterns section, AND the Known Pitfalls section. The Known Pitfalls section largely restates information already covered in individual workflow pitfalls. Some explanatory text could be trimmed (e.g., 'When to use' descriptions are somewhat obvious).

2 / 3

Actionability

Tool sequences and key parameters are clearly listed, which is helpful. However, there is no truly executable code—the 'code' blocks are pseudocode step lists rather than actual tool invocations with complete parameter examples. The JSON example for user properties is a good concrete snippet, but most workflows lack copy-paste-ready tool call examples with full parameter structures.

2 / 3

Workflow Clarity

Multi-step workflows are clearly sequenced with numbered steps, prerequisite/required/optional labels, and explicit validation patterns (e.g., the async cohort operation pattern with status checking loop, the ID resolution prerequisite before GET_USER_ACTIVITY). The setup section includes a verification step before proceeding.

3 / 3

Progressive Disclosure

The content is well-organized with clear sections and a quick reference table, but it's a monolithic ~180-line document with no bundle files to offload detail into. The repeated pitfalls and detailed parameter lists for each workflow could be split into separate reference files. The single external link to Composio docs is appropriate but the skill itself could benefit from splitting detailed workflow docs out.

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.