Automate Segment tasks via Rube MCP (Composio): track events, identify users, manage groups, page views, aliases, batch operations. Always search tools first for current schemas.
67
51%
Does it follow best practices?
Impact
98%
1.16xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/segment-automation/SKILL.mdQuality
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 listing specific capabilities and identifying its niche (Segment automation via Composio/Rube MCP), making it distinctive and specific. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill. Adding common user-facing trigger terms beyond the technical vocabulary would also improve discoverability.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Segment analytics, tracking user events, or managing customer data through Composio.'
Include additional natural trigger terms users might say, such as 'analytics', 'customer data platform', 'Segment API', or 'user tracking'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'track events, identify users, manage groups, page views, aliases, batch operations.' Also specifies the tooling context (Rube MCP, Composio) and includes a procedural instruction ('search tools first for current schemas'). | 3 / 3 |
Completeness | The 'what' is well-covered (automate Segment tasks with specific actions listed), but there is no explicit 'Use when...' clause or equivalent trigger guidance. The when is only implied by the domain context. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2. | 2 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Segment', 'track events', 'identify users', 'groups', 'page views', 'aliases', 'batch operations', and 'Composio'. However, it misses common user variations like 'analytics', 'user tracking', 'Segment API', or 'customer data platform' that users might naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to Segment via Rube MCP (Composio), which is a clear niche. The combination of 'Segment', 'Composio', and 'Rube MCP' makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is comprehensive in coverage of Segment operations but suffers from significant verbosity and repetition. The same caveats (userId/anonymousId requirements, ISO 8601 timestamps) appear in nearly every section, and much of the content explains Segment concepts Claude already understands. The skill would benefit greatly from consolidation, concrete executable examples, and splitting detailed per-tool documentation into referenced files.
Suggestions
Consolidate repeated pitfalls (userId/anonymousId requirement, ISO 8601 timestamps, response parsing) into a single 'Common Requirements' section instead of repeating them in every workflow.
Add concrete, executable tool invocation examples showing actual JSON payloads for at least SEGMENT_TRACK and SEGMENT_BATCH calls.
Move detailed per-tool parameter lists and pitfalls to a separate reference file, keeping SKILL.md as a concise overview with the quick reference table and common patterns.
Add explicit error recovery steps for batch operations: what to do when individual messages fail, how to retry, and how to validate results.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~180+ lines with significant repetition. The same pitfalls (userId/anonymousId required, ISO 8601 timestamps) are repeated across nearly every workflow section. The 'Known Pitfalls' section largely duplicates pitfalls already listed in individual workflows. Much of this content (what track/identify/page calls do, how Segment works) is knowledge Claude already has. | 1 / 3 |
Actionability | Provides specific tool names and parameter lists, which is useful. However, there are no executable code examples or concrete JSON payloads showing actual tool invocations. The 'Common Patterns' sections use pseudocode-style numbered lists rather than actual call examples with real parameters. | 2 / 3 |
Workflow Clarity | Each workflow has a clear tool sequence and the setup section has a good 4-step verification flow. However, for batch operations (a destructive/bulk operation), there's no explicit validation or error recovery feedback loop — just 'check response for any individual message errors' without specifying what to do on failure. The user lifecycle pattern is well-sequenced but lacks validation checkpoints. | 2 / 3 |
Progressive Disclosure | The content is a monolithic wall of text with no references to external files for detailed information. The quick reference table at the end is helpful, but the 180+ lines of inline content covering every workflow, pitfall, and pattern could benefit from splitting detailed per-tool documentation into separate files. The single external link to Composio docs is good but insufficient for the volume of content. | 2 / 3 |
Total | 7 / 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 | |
7cc63f3
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.