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 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'.

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 ('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.

DimensionReasoningScore

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.

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.