CtrlK
BlogDocsLog inGet started
Tessl Logo

segment-automation

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

1.16x
Quality

51%

Does it follow best practices?

Impact

98%

1.16x

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/segment-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 listing specific capabilities and identifying its niche (Segment automation via Composio/Rube MCP), making it distinctive and actionable. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill. Adding a few more natural trigger terms users might say 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 Segment data via Composio.'

Include additional natural trigger terms like 'analytics', 'customer data platform', 'Segment API', or 'user tracking' to improve keyword coverage.

DimensionReasoningScore

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 ('Always 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 terms. 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 the specific platform (Segment), the specific tooling (Rube MCP/Composio), and the enumerated actions 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.

The skill is comprehensive in covering Segment's API surface through Rube MCP, with good tool naming and parameter documentation. However, it is significantly too verbose with heavy repetition of common pitfalls across sections, lacks concrete executable examples (no actual JSON payloads or tool call demonstrations), and misses validation/error-recovery steps for batch operations. The skill contradicts its own advice to 'always call RUBE_SEARCH_TOOLS first to get current tool schemas' by exhaustively documenting parameters that would be returned by that search.

Suggestions

Eliminate repeated pitfalls (userId/anonymousId requirement, ISO 8601 timestamps) by consolidating them into a single 'Common Requirements' section and removing duplicates from individual workflows.

Add at least one concrete, copy-paste-ready example showing an actual tool invocation with realistic parameter values (e.g., a complete SEGMENT_TRACK call with sample userId, event name, and properties object).

Add explicit error-recovery feedback loops for batch operations: what to check in the response, how to retry failed messages, and when to escalate.

Since the skill instructs to use RUBE_SEARCH_TOOLS for current schemas, reduce inline parameter documentation to only non-obvious gotchas and let the tool search provide the rest.

DimensionReasoningScore

Conciseness

Highly verbose and repetitive. The same pitfalls (userId/anonymousId required, ISO 8601 timestamps) are repeated across nearly every workflow section. The 'Known Pitfalls' section at the end largely duplicates pitfalls already stated in each workflow. Many parameters are described that Claude could discover via RUBE_SEARCH_TOOLS, which the skill itself says to use first. The document could be cut by 50%+ without losing actionable information.

1 / 3

Actionability

Provides specific tool names, parameter lists, and naming conventions, which is useful. However, there are no executable code examples or concrete JSON payloads showing actual tool invocations. The 'Common Patterns' sections use pseudocode-like numbered lists rather than actual call examples with sample parameters. Claude would benefit from at least one complete example of a tool call with real parameter values.

2 / 3

Workflow Clarity

Workflows are listed with clear sequences and the setup section has a good 4-step verification flow. However, for batch operations (a destructive/bulk context), there are no explicit validation or error-recovery feedback loops — 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 supporting files. All pitfalls, patterns, and detailed parameter lists are inline. The quick reference table at the end is helpful, but the 150+ lines of per-workflow detail could be split into separate references. Given no bundle files exist, the content should at minimum be better organized with a concise overview and collapsible or separated detail sections.

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.

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.