CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

intercom-automation

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

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/intercom-automation/SKILL.md

The canonical home for this skill is intercom-automation in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

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

A dense, largely actionable API guide with concrete tool slugs, parameters, and pitfalls, but it carries redundant filler, lacks validation checkpoints for destructive/batch operations, and inlines ~250 lines of reference material that should live in separate bundle files.

Suggestions

Split the per-tool sequences and the Quick Reference table into a references/ file (e.g., references/tools.md), keeping SKILL.md as a workflow overview with one-level-deep, clearly signaled references.

Add explicit validation checkpoints to destructive and batch workflows, e.g., verify the contact-company association before and after DETACH_A_CONTACT, and confirm reply success by re-fetching the conversation to catch duplicate sends.

Remove the empty 'When to Use' filler section and deduplicate the RUBE_SEARCH_TOOLS instructions between Prerequisites and Setup to cut token overhead.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful API specifics (parameters, operators, pitfalls), but it includes clear padding: the 'When to Use' section is pure filler ('This skill is applicable to execute the workflow or actions described in the overview'), the Quick Reference table re-lists all 21 tool slugs already enumerated in the Core Workflows, and Prerequisites and Setup both restate the RUBE_SEARCH_TOOLS instruction. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where such trims would be minor.

3 / 5

Actionability

Tool sequences name exact tool slugs with roles ([Prerequisite]/[Optional]), key parameters are enumerated, the search-filter JSON examples are copy-paste ready, and pagination mechanics are concrete. It falls short of anchor 5 because no complete end-to-end tool invocation example is given (e.g., a full reply-to-conversation call with real arguments) — though the 'always call RUBE_SEARCH_TOOLS first for current schemas' instruction partially justifies this.

4 / 5

Workflow Clarity

Sequences are clearly ordered with labeled steps and the Setup section includes verification ('Confirm connection status shows ACTIVE'), matching the sequence quality of anchor 4. However, destructive operations (DETACH_A_CONTACT removes a contact-company association) and batch/paginated operations have no post-action validation or verification checkpoints, which the rubric's scoring notes explicitly cap at 3.

3 / 5

Progressive Disclosure

The content is well-sectioned but entirely inlined: ~250 lines of tool-by-tool sequences plus a 21-row reference table that would fit naturally in one or more reference files, with no references/ bundle present. This matches anchor 3 ('content that should be separate is inline', e.g., 200 lines of API reference) rather than 2, because section structure and navigation within the file are good.

3 / 5

Total

13

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, well-scoped description with strong domain keywords and low conflict risk, undermined by the total absence of a 'when to use' clause and generic verb choice ('Automate tasks') instead of concrete actions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions Intercom, support conversations, customer contacts, or help-desk workflows.'

Replace the generic 'Automate Intercom tasks' with concrete actions per entity, e.g. 'Search and reply to support conversations, assign/close/reopen tickets, manage contacts and companies, list segments and admins.'

Drop or shorten 'Always search tools first for current schemas' from the description — it is operational guidance, not trigger or capability information, and belongs in the body.

DimensionReasoningScore

Specificity

The description enumerates five concrete Intercom object areas ('conversations, contacts, companies, segments, admins'), but the only verb is the generic 'Automate Intercom tasks' — no per-object actions such as reply, assign, close, or search. This matches anchor 4 (several specific items, minor gaps) rather than 5, which requires multiple concrete action verbs, and exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clearly stated ('Automate Intercom tasks via Rube MCP (Composio): conversations, contacts, companies, segments, admins') but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere — the rubric explicitly caps completeness at 3 for this. It is not 2 because the 'what' is specific and multi-part, not vague.

3 / 5

Trigger Term Quality

Natural Intercom terms like 'conversations', 'contacts', 'companies', 'segments', and 'admins' give good keyword coverage, matching anchor 4. It is not 5 because common user phrasings such as 'support tickets', 'help desk', or 'live chat' are missing, and the trailing sentence 'Always search tools first for current schemas' adds no trigger value.

4 / 5

Distinctiveness Conflict Risk

Intercom is a specific named product with a distinct niche (customer messaging/support platform), further narrowed by 'via Rube MCP (Composio)'. This gives clear, distinct triggers with minimal overlap risk against other skills, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/intercom-automation/SKILL.md

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.