{"id":"723ba233-404e-4cf0-956d-d88911c86bfa","shortId":"JbcpAn","kind":"skill","title":"segment-automation","tagline":"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.","description":"# Segment Automation via Rube MCP\n\nAutomate Segment customer data platform operations through Composio's Segment toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Segment connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `segment`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `segment`\n3. If connection is not ACTIVE, follow the returned auth link to complete Segment authentication\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Track Events\n\n**When to use**: User wants to send event data to Segment for downstream destinations\n\n**Tool sequence**:\n1. `SEGMENT_TRACK` - Send a single track event [Required]\n\n**Key parameters**:\n- `userId`: User identifier (required if no `anonymousId`)\n- `anonymousId`: Anonymous identifier (required if no `userId`)\n- `event`: Event name (e.g., 'Order Completed', 'Button Clicked')\n- `properties`: Object with event-specific properties\n- `timestamp`: ISO 8601 timestamp (optional; defaults to server time)\n- `context`: Object with contextual metadata (IP, user agent, etc.)\n\n**Pitfalls**:\n- At least one of `userId` or `anonymousId` is required\n- `event` name is required and should follow consistent naming conventions\n- Properties are freeform objects; ensure consistent schema across events\n- Timestamp must be ISO 8601 format (e.g., '2024-01-15T10:30:00Z')\n- Events are processed asynchronously; successful API response means accepted, not delivered\n\n### 2. Identify Users\n\n**When to use**: User wants to associate traits with a user profile in Segment\n\n**Tool sequence**:\n1. `SEGMENT_IDENTIFY` - Set user traits and identity [Required]\n\n**Key parameters**:\n- `userId`: User identifier (required if no `anonymousId`)\n- `anonymousId`: Anonymous identifier\n- `traits`: Object with user properties (email, name, plan, etc.)\n- `timestamp`: ISO 8601 timestamp\n- `context`: Contextual metadata\n\n**Pitfalls**:\n- At least one of `userId` or `anonymousId` is required\n- Traits are merged with existing traits, not replaced\n- To remove a trait, set it to `null`\n- Identify calls should be made before track calls for new users\n- Avoid sending PII in traits unless destinations are configured for it\n\n### 3. Batch Operations\n\n**When to use**: User wants to send multiple events, identifies, or other calls in a single request\n\n**Tool sequence**:\n1. `SEGMENT_BATCH` - Send multiple Segment calls in one request [Required]\n\n**Key parameters**:\n- `batch`: Array of message objects, each with:\n  - `type`: Message type ('track', 'identify', 'group', 'page', 'alias')\n  - `userId` / `anonymousId`: User identifier\n  - Additional fields based on type (event, properties, traits, etc.)\n\n**Pitfalls**:\n- Each message in the batch must have a valid `type` field\n- Maximum batch size limit applies; check schema for current limit\n- All messages in a batch are processed independently; one failure does not affect others\n- Each message must independently satisfy its type's requirements (e.g., track needs event name)\n- Batch is the most efficient way to send multiple calls; prefer over individual calls\n\n### 4. Group Users\n\n**When to use**: User wants to associate a user with a company, team, or organization\n\n**Tool sequence**:\n1. `SEGMENT_GROUP` - Associate user with a group [Required]\n\n**Key parameters**:\n- `userId`: User identifier (required if no `anonymousId`)\n- `anonymousId`: Anonymous identifier\n- `groupId`: Group/organization identifier (required)\n- `traits`: Object with group properties (name, industry, size, plan)\n- `timestamp`: ISO 8601 timestamp\n\n**Pitfalls**:\n- `groupId` is required; it identifies the company or organization\n- Group traits are merged with existing traits for that group\n- A user can belong to multiple groups\n- Group traits update the group profile, not the user profile\n\n### 5. Track Page Views\n\n**When to use**: User wants to record page view events in Segment\n\n**Tool sequence**:\n1. `SEGMENT_PAGE` - Send a page view event [Required]\n\n**Key parameters**:\n- `userId`: User identifier (required if no `anonymousId`)\n- `anonymousId`: Anonymous identifier\n- `name`: Page name (e.g., 'Home', 'Pricing', 'Dashboard')\n- `category`: Page category (e.g., 'Docs', 'Marketing')\n- `properties`: Object with page-specific properties (url, title, referrer)\n\n**Pitfalls**:\n- At least one of `userId` or `anonymousId` is required\n- `name` and `category` are optional but recommended for proper analytics\n- Standard properties include `url`, `title`, `referrer`, `path`, `search`\n- Page calls are often automated; manual use is for server-side page tracking\n\n### 6. Alias Users and Manage Sources\n\n**When to use**: User wants to merge anonymous and identified users, or manage source configuration\n\n**Tool sequence**:\n1. `SEGMENT_ALIAS` - Link two user identities together [Optional]\n2. `SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE` - View source schema settings [Optional]\n3. `SEGMENT_UPDATE_SOURCE` - Update source configuration [Optional]\n\n**Key parameters**:\n- For ALIAS:\n  - `userId`: New user identifier (the identified ID)\n  - `previousId`: Old user identifier (the anonymous ID)\n- For source operations:\n  - `sourceId`: Source identifier\n\n**Pitfalls**:\n- ALIAS is a one-way operation; cannot be undone\n- `previousId` is the anonymous/old ID, `userId` is the new/identified ID\n- Not all destinations support alias calls; check destination documentation\n- ALIAS should be called once when a user first identifies (e.g., signs up)\n- Source updates may affect data collection; review changes carefully\n\n## Common Patterns\n\n### User Lifecycle\n\nStandard Segment user lifecycle:\n```\n1. Anonymous user visits -> PAGE call with anonymousId\n2. User interacts -> TRACK call with anonymousId\n3. User signs up -> ALIAS (anonymousId -> userId), then IDENTIFY with traits\n4. User takes action -> TRACK call with userId\n5. User joins org -> GROUP call linking userId to groupId\n```\n\n### Batch Optimization\n\nFor bulk data ingestion:\n```\n1. Collect events in memory (array of message objects)\n2. Each message includes type, userId/anonymousId, and type-specific fields\n3. Call SEGMENT_BATCH with the collected messages\n4. Check response for any individual message errors\n```\n\n### Naming Conventions\n\nSegment recommends consistent event naming:\n- **Events**: Use \"Object Action\" format (e.g., 'Order Completed', 'Article Viewed')\n- **Properties**: Use snake_case (e.g., 'order_total', 'product_name')\n- **Traits**: Use snake_case (e.g., 'first_name', 'plan_type')\n\n## Known Pitfalls\n\n**Identity Resolution**:\n- Always include `userId` or `anonymousId` on every call\n- Use ALIAS only once per user identity merge\n- Identify before tracking to ensure proper user association\n\n**Data Quality**:\n- Event names should be consistent across all sources\n- Properties should follow a defined schema for downstream compatibility\n- Avoid sending sensitive PII unless destinations are configured for it\n\n**Rate Limits**:\n- Use BATCH for bulk operations to stay within rate limits\n- Individual calls are rate-limited per source\n- Batch calls are more efficient and less likely to be throttled\n\n**Response Parsing**:\n- Successful responses indicate acceptance, not delivery to destinations\n- Response data may be nested under `data` key\n- Check for error fields in batch responses for individual message failures\n\n**Timestamps**:\n- Must be ISO 8601 format with timezone (e.g., '2024-01-15T10:30:00Z')\n- Omitting timestamp uses server receive time\n- Historical data imports should include explicit timestamps\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Track event | SEGMENT_TRACK | userId, event, properties |\n| Identify user | SEGMENT_IDENTIFY | userId, traits |\n| Batch calls | SEGMENT_BATCH | batch (array of messages) |\n| Group user | SEGMENT_GROUP | userId, groupId, traits |\n| Page view | SEGMENT_PAGE | userId, name, properties |\n| Alias identity | SEGMENT_ALIAS | userId, previousId |\n| Source schema | SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE | sourceId |\n| Update source | SEGMENT_UPDATE_SOURCE | sourceId |\n| Warehouses | SEGMENT_LIST_CONNECTED_WAREHOUSES_FROM_SOURCE | sourceId |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["segment","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-segment-automation","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/segment-automation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34583 github stars · SKILL.md body (8,895 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T18:52:12.983Z","embedding":null,"createdAt":"2026-04-18T21:44:09.884Z","updatedAt":"2026-04-22T18:52:12.983Z","lastSeenAt":"2026-04-22T18:52:12.983Z","tsv":"'-01':267,1097 '-15':268,1098 '/mcp':86 '00z':271,1101 '1':106,153,172,302,409,534,627,736,849,899 '2':118,283,745,857,908 '2024':266,1096 '3':126,387,757,864,919 '30':270,1100 '4':141,514,875,927 '5':609,883 '6':713 '8601':214,263,334,570,1091 'accept':280,1063 'across':257,1005 'action':878,945,1198 'activ':58,131,146 'add':83,100 'addit':441 'affect':484,835 'agent':228 'alia':436,714,738,768,790,814,819,868,983,1157,1160 'alias':19 'alway':22,68,974 'analyt':690 'anonym':191,321,553,646,726,781,850 'anonymous/old':803 'anonymousid':189,190,237,319,320,346,438,551,552,644,645,678,856,863,869,978 'api':96,277 'appli':466 'applic':1192 'array':423,904,1140 'articl':950 'ask':1236 'associ':292,523,537,997 'asynchron':275 'auth':135 'authent':140 'autom':3,4,30,34,703 'avail':57,111 'avoid':376,1017 'base':443 'batch':20,388,411,422,455,463,476,500,893,922,1030,1047,1081,1135,1138,1139 'belong':595 'boundari':1244 'bulk':896,1032 'button':203 'call':69,119,366,372,402,415,509,513,700,815,822,854,861,880,888,920,981,1040,1048,1136 'cannot':797 'care':840 'case':955,964 'categori':655,657,683 'chang':839 'check':467,816,928,1076 'clarif':1238 'clear':1211 'click':204 'client':93 'collect':837,900,925 'common':841 'compani':528,579 'compat':1016 'complet':138,202,949 'composio':10,41 'configur':94,384,733,763,1024 'confirm':113,142 'connect':53,60,64,122,128,143,1181 'consist':247,255,939,1004 'context':221,336 'contextu':224,337 'convent':249,936 'core':151 'criteria':1247 'current':27,76,470 'custom':36 'dashboard':654 'data':37,164,836,897,998,1069,1074,1109 'default':217 'defin':1012 'deliv':282 'deliveri':1065 'describ':1199,1215 'destin':169,382,812,817,1022,1067 'doc':659 'document':818 'downstream':168,1015 'e.g':200,265,495,651,658,829,947,956,965,1095 'effici':504,1051 'email':328 'endpoint':102 'ensur':254,994 'environ':1227 'environment-specif':1226 'error':934,1078 'etc':229,331,449 'event':12,155,163,179,197,198,209,240,258,272,398,446,498,622,634,901,940,942,1000,1123,1127 'event-specif':208 'everi':980 'execut':1194 'exist':353,587 'expert':1232 'explicit':1113 'failur':481,1086 'field':442,461,918,1079 'first':25,73,827,966 'follow':132,246,1010 'format':264,946,1092 'freeform':252 'get':75,80 'group':16,434,515,536,541,562,582,591,598,599,603,887,1143,1146 'group/organization':556 'groupid':555,573,892,1148 'histor':1108 'home':652 'id':775,782,804,809 'ident':309,742,972,988,1158 'identifi':13,185,192,284,304,315,322,365,399,433,440,547,554,557,577,640,647,728,772,774,779,788,828,872,990,1129,1132 'import':1110 'includ':693,911,975,1112 'independ':479,489 'indic':1062 'individu':512,932,1039,1084 'industri':565 'ingest':898 'input':1241 'interact':859 'ip':226 'iso':213,262,333,569,1090 'join':885 'key':97,181,311,420,543,636,765,1075,1120 'known':970 'least':232,341,673 'less':1053 'lifecycl':844,848 'like':1054 'limit':465,471,1028,1038,1044,1203 'link':136,739,889 'list':747,1166,1180 'made':369 'manag':15,63,121,717,731 'manual':704 'market':660 'match':1212 'maximum':462 'may':834,1070 'mcp':9,33,47,50,82,89,109 'mean':279 'memori':903 'merg':351,585,725,989 'messag':425,430,452,473,487,906,910,926,933,1085,1142 'metadata':225,338 'miss':1249 'multipl':397,413,508,597 'must':51,260,456,488,1088 'name':199,241,248,329,499,564,648,650,681,935,941,960,967,1001,1155 'need':98,497 'nest':1072 'new':374,770 'new/identified':808 'null':364 'object':206,222,253,324,426,560,662,907,944 'often':702 'old':777 'omit':1102 'one':233,342,417,480,674,794 'one-way':793 'oper':21,39,389,785,796,1033 'optim':894 'option':216,685,744,756,764 'order':201,948,957 'org':886 'organ':531,581 'other':485 'output':1221 'overview':1202 'page':17,435,611,620,629,632,649,656,665,699,711,853,1150,1153 'page-specif':664 'param':1121 'paramet':182,312,421,544,637,766 'pars':1059 'path':697 'pattern':842 'per':986,1045 'permiss':1242 'pii':378,1020 'pitfal':230,339,450,572,671,789,971 'plan':330,567,968 'platform':38 'prefer':510 'prerequisit':48 'previousid':776,800,1162 'price':653 'process':274,478 'product':959 'profil':297,604,608 'proper':689,995 'properti':205,211,250,327,447,563,661,667,692,952,1008,1128,1156 'qualiti':999 'quick':1115 'rate':1027,1037,1043 'rate-limit':1042 'receiv':1106 'recommend':687,938 'record':619 'refer':1116 'referr':670,696 'remov':358 'replac':356 'request':406,418 'requir':180,186,193,239,243,310,316,348,419,494,542,548,558,575,635,641,680,1240 'resolut':973 'respond':117 'respons':278,929,1058,1061,1068,1082 'return':134 'review':838,1233 'rube':8,32,46,49,54,62,70,81,108,114,120 'rube.app':85 'rube.app/mcp':84 'run':148 'safeti':1243 'satisfi':490 'schema':28,78,256,468,748,754,1013,1164,1167 'scope':1214 'search':23,55,71,115,698 'segment':2,5,29,35,43,59,67,125,139,166,173,299,303,410,414,535,624,628,737,746,758,846,921,937,1124,1131,1137,1145,1152,1159,1165,1174,1179 'segment-autom':1 'send':162,175,377,396,412,507,630,1018 'sensit':1019 'sequenc':171,301,408,533,626,735 'server':90,219,709,1105 'server-sid':708 'set':305,361,749,755,1168 'setup':79 'show':145 'side':710 'sign':830,866 'singl':177,405 'size':464,566 'skill':1190,1206 'skill-segment-automation' 'slug':1119 'snake':954,963 'sourc':718,732,751,753,760,762,784,787,832,1007,1046,1163,1170,1173,1176,1184 'source-sickn33' 'sourceid':786,1171,1177,1185 'specif':210,666,917,1228 'standard':691,845 'status':144 'stay':1035 'stop':1234 'substitut':1224 'success':276,1060,1246 'support':813 't10':269,1099 'take':877 'task':6,1117,1210 'team':529 'test':1230 'throttl':1057 'time':220,1107 'timestamp':212,215,259,332,335,568,571,1087,1103,1114 'timezon':1094 'titl':669,695 'togeth':743 'tool':24,56,72,77,116,170,300,407,532,625,734,1118 'toolkit':44,66,124 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'total':958 'track':11,154,174,178,371,432,496,610,712,860,879,992,1122,1125 'trait':293,307,323,349,354,360,380,448,559,583,588,600,874,961,1134,1149 'treat':1219 'two':740 'type':429,431,445,460,492,912,916,969 'type-specif':915 'undon':799 'unless':381,1021 'updat':601,759,761,833,1172,1175 'url':668,694 'use':158,288,392,519,615,705,721,943,953,962,982,1029,1104,1188,1204 'user':14,159,184,227,285,289,296,306,314,326,375,393,439,516,520,525,538,546,593,607,616,639,715,722,729,741,771,778,826,843,847,851,858,865,876,884,987,996,1130,1144 'userid':183,196,235,313,344,437,545,638,676,769,805,870,882,890,976,1126,1133,1147,1154,1161 'userid/anonymousid':913 'valid':459,1229 'verifi':107 'via':7,31,45,61 'view':18,612,621,633,752,951,1151 'visit':852 'want':160,290,394,521,617,723 'warehous':1178,1182 'way':505,795 'within':1036 'work':105 'workflow':150,152,1196","prices":[{"id":"7a150f92-bdda-459b-9139-c9ea705c0d64","listingId":"723ba233-404e-4cf0-956d-d88911c86bfa","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:44:09.884Z"}],"sources":[{"listingId":"723ba233-404e-4cf0-956d-d88911c86bfa","source":"github","sourceId":"sickn33/antigravity-awesome-skills/segment-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/segment-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:44:09.884Z","lastSeenAt":"2026-04-22T18:52:12.983Z"}],"details":{"listingId":"723ba233-404e-4cf0-956d-d88911c86bfa","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"segment-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34583,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"21c317d0028700bc9541eea20284d39c16d92983","skill_md_path":"skills/segment-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/segment-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"segment-automation","description":"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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/segment-automation"},"updatedAt":"2026-04-22T18:52:12.983Z"}}