CtrlK
BlogDocsLog inGet started
Tessl Logo

intercom-automation

Automate Intercom tasks via Rube MCP (Composio): conversations, contacts, companies, segments, admins. Always search tools first for current schemas.

68

1.55x
Quality

53%

Does it follow best practices?

Impact

92%

1.55x

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/intercom-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 (Intercom automation via Rube MCP/Composio) and lists relevant entity types, giving it good distinctiveness. However, it lacks specific concrete actions beyond 'automate tasks' and is missing an explicit 'Use when...' clause, which limits its effectiveness for skill selection. The trigger terms cover Intercom entities but miss natural user language around customer support workflows.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Intercom, customer messaging, support conversations, or managing contacts/companies in Intercom.'

Replace the vague 'Automate Intercom tasks' with specific actions like 'List, search, and reply to Intercom conversations; create and update contacts and companies; manage segments and admin assignments.'

Include natural user terms like 'customer support', 'help desk', 'messaging platform', 'tickets' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (Intercom via Rube MCP/Composio) and lists entity types (conversations, contacts, companies, segments, admins), but doesn't describe specific concrete actions like 'create contacts', 'list conversations', or 'update segments'.

2 / 3

Completeness

The 'what' is partially addressed (automate Intercom tasks with listed entities), but there is no explicit 'Use when...' clause or equivalent trigger guidance telling Claude when to select this skill.

2 / 3

Trigger Term Quality

Includes relevant keywords like 'Intercom', 'conversations', 'contacts', 'companies', 'segments', 'admins', and 'Composio', but misses common user phrasings like 'customer support', 'messaging', 'tickets', 'CRM', or action-oriented terms users might say.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Intercom', 'Rube MCP', and 'Composio' creates a very specific niche that is unlikely to conflict with other skills. The platform-specific naming makes it clearly distinguishable.

3 / 3

Total

9

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a comprehensive Intercom automation reference that covers many workflows with clear tool sequences and useful pitfall warnings. Its main weaknesses are repetition across sections (especially admin ID requirements and HTML handling), lack of concrete executable tool call examples, and missing validation/verification steps in workflows that involve non-idempotent operations. The content would benefit from deduplication and adding explicit success-verification checkpoints.

Suggestions

Add concrete, complete tool invocation examples for at least 2-3 key operations (e.g., creating a conversation, replying) showing exact parameter structures rather than just listing parameter names.

Add explicit validation/verification steps to workflows—e.g., after creating a conversation, verify the returned ID; after assigning, confirm the assignment via GET_CONVERSATION.

Deduplicate repeated pitfalls (admin ID requirements, HTML handling, idempotency) by consolidating them in the 'Known Pitfalls' section and referencing it from individual workflows instead of restating.

Consider extracting the Quick Reference table and detailed per-workflow parameter/pitfall lists into a separate REFERENCE.md to keep the main skill focused on workflows and common patterns.

DimensionReasoningScore

Conciseness

The skill is reasonably well-organized but quite verbose for what it covers. There's significant repetition—pitfalls about admin IDs are repeated across multiple sections, HTML content handling is mentioned multiple times, and the 'Known Pitfalls' section largely duplicates information already stated in individual workflow pitfalls. The quick reference table is useful but adds length. Some trimming would improve token efficiency.

2 / 3

Actionability

The skill provides specific tool names, parameter names, and JSON examples for search filters, which is helpful. However, it relies on the user calling RUBE_SEARCH_TOOLS for actual schemas rather than providing executable examples of full tool calls. The tool sequences are listed but lack concrete invocation examples showing exact parameter structures for most operations. The search query filter examples are the strongest actionable element.

2 / 3

Workflow Clarity

Workflows are clearly sequenced with numbered steps and labeled as Required/Optional/Prerequisite, which is good. However, there are no explicit validation checkpoints or error recovery feedback loops. For operations like creating conversations or sending replies (which are noted as non-idempotent), there's no validate-then-proceed pattern. The setup section has a reasonable verification flow, but core workflows lack 'verify success' steps.

2 / 3

Progressive Disclosure

The content is structured with clear sections and headers, and the quick reference table aids navigation. However, with no bundle files, all content is monolithic in a single file. The extensive per-workflow pitfalls, parameter lists, and the full reference table could benefit from being split into separate reference files. The single external link to Composio docs is appropriate but the skill itself is quite long for a single file.

2 / 3

Total

8

/

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.