Automate Amplitude tasks via Rube MCP (Composio): events, user activity, cohorts, user identification. Always search tools first for current schemas.
70
60%
Does it follow best practices?
Impact
83%
1.23xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/amplitude-automation/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
74c7031
Table of Contents
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.