{"id":"59eeaa1c-3a26-4f35-b3b6-cac5ad48e7f5","shortId":"GG32gg","kind":"skill","title":"zendesk-automation","tagline":"Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.","description":"# Zendesk Automation via Rube MCP\n\nAutomate Zendesk operations through Composio's Zendesk toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Zendesk connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `zendesk`\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 `zendesk`\n3. If connection is not ACTIVE, follow the returned auth link to complete Zendesk auth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. List and Search Tickets\n\n**When to use**: User wants to view, filter, or search support tickets\n\n**Tool sequence**:\n1. `ZENDESK_LIST_ZENDESK_TICKETS` - List all tickets with pagination [Required]\n2. `ZENDESK_GET_ZENDESK_TICKET_BY_ID` - Get specific ticket details [Optional]\n\n**Key parameters**:\n- `page`: Page number (1-based)\n- `per_page`: Results per page (max 100)\n- `sort_by`: Sort field ('created_at', 'updated_at', 'priority', 'status')\n- `sort_order`: 'asc' or 'desc'\n- `ticket_id`: Ticket ID for single retrieval\n\n**Pitfalls**:\n- LIST uses `page`/`per_page` pagination, NOT offset-based; check `next_page` in response\n- Maximum 100 results per page; iterate with page numbers until `next_page` is null\n- Deleted tickets are not returned by LIST; use GET_BY_ID which returns status 'deleted'\n- Ticket comments and audits are included in GET_BY_ID but not in LIST responses\n\n### 2. Create and Update Tickets\n\n**When to use**: User wants to create new tickets or modify existing ones\n\n**Tool sequence**:\n1. `ZENDESK_SEARCH_ZENDESK_USERS` - Find requester/assignee [Prerequisite]\n2. `ZENDESK_CREATE_ZENDESK_TICKET` - Create a new ticket [Required]\n3. `ZENDESK_UPDATE_ZENDESK_TICKET` - Update ticket fields [Optional]\n4. `ZENDESK_DELETE_ZENDESK_TICKET` - Delete a ticket [Optional]\n\n**Key parameters**:\n- `subject`: Ticket subject line\n- `description`: Ticket body (for creation; becomes first comment)\n- `priority`: 'urgent', 'high', 'normal', 'low'\n- `status`: 'new', 'open', 'pending', 'hold', 'solved', 'closed'\n- `type`: 'problem', 'incident', 'question', 'task'\n- `assignee_id`: Agent user ID to assign\n- `requester_id`: Requester user ID\n- `tags`: Array of tag strings\n- `ticket_id`: Ticket ID (for update/delete)\n\n**Pitfalls**:\n- Tags on UPDATE REPLACE existing tags entirely; merge with current tags to preserve them\n- Use `safe_update` with `updated_stamp` to prevent concurrent modification conflicts\n- DELETE is permanent and irreversible; tickets cannot be recovered\n- `description` is only used on creation; use REPLY_ZENDESK_TICKET to add comments after creation\n- Closed tickets cannot be updated; create a follow-up ticket instead\n\n### 3. Reply to Tickets\n\n**When to use**: User wants to add comments or replies to tickets\n\n**Tool sequence**:\n1. `ZENDESK_GET_ZENDESK_TICKET_BY_ID` - Get current ticket state [Prerequisite]\n2. `ZENDESK_REPLY_ZENDESK_TICKET` - Add a reply/comment [Required]\n\n**Key parameters**:\n- `ticket_id`: Ticket ID to reply to\n- `body`: Reply text content\n- `public`: Boolean; true for public reply, false for internal note\n- `author_id`: Author user ID (defaults to authenticated user)\n\n**Pitfalls**:\n- Set `public: false` for internal notes visible only to agents\n- Default is public reply which sends email to requester\n- HTML is supported in body text\n- Replying can also update ticket status simultaneously\n\n### 4. Manage Users\n\n**When to use**: User wants to find or create Zendesk users (agents, end-users)\n\n**Tool sequence**:\n1. `ZENDESK_SEARCH_ZENDESK_USERS` - Search for users [Required]\n2. `ZENDESK_CREATE_ZENDESK_USER` - Create a new user [Optional]\n3. `ZENDESK_GET_ABOUT_ME` - Get authenticated user info [Optional]\n\n**Key parameters**:\n- `query`: Search string (matches name, email, phone, etc.)\n- `name`: User's full name (required for creation)\n- `email`: User's email address\n- `role`: 'end-user', 'agent', or 'admin'\n- `verified`: Whether email is verified\n\n**Pitfalls**:\n- User search is fuzzy; may return partial matches\n- Creating a user with an existing email returns the existing user (upsert behavior)\n- Agent and admin roles may require specific plan features\n\n### 5. Manage Organizations\n\n**When to use**: User wants to list, create, or manage organizations\n\n**Tool sequence**:\n1. `ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS` - List all organizations [Required]\n2. `ZENDESK_GET_ZENDESK_ORGANIZATION` - Get specific organization [Optional]\n3. `ZENDESK_CREATE_ZENDESK_ORGANIZATION` - Create organization [Optional]\n4. `ZENDESK_UPDATE_ZENDESK_ORGANIZATION` - Update organization [Optional]\n5. `ZENDESK_COUNT_ZENDESK_ORGANIZATIONS` - Get total count [Optional]\n\n**Key parameters**:\n- `name`: Organization name (unique, required for creation)\n- `organization_id`: Organization ID for get/update\n- `details`: Organization details text\n- `notes`: Internal notes\n- `domain_names`: Array of associated domains\n- `tags`: Array of tag strings\n\n**Pitfalls**:\n- Organization names must be unique; duplicate names cause creation errors\n- Tags on UPDATE REPLACE existing tags (same behavior as tickets)\n- Domain names can be used for automatic user association\n\n## Common Patterns\n\n### Pagination\n\n**List endpoints**:\n- Use `page` (1-based) and `per_page` (max 100)\n- Check `next_page` URL in response; null means last page\n- `count` field gives total results\n\n### Ticket Lifecycle\n\n```\nnew -> open -> pending -> solved -> closed\n                  |          ^\n                  v          |\n                hold --------+\n```\n\n- `new`: Unassigned ticket\n- `open`: Assigned, being worked on\n- `pending`: Waiting for customer response\n- `hold`: Waiting for internal action\n- `solved`: Resolved, can be reopened\n- `closed`: Permanently closed, cannot be modified\n\n### User Search for Assignment\n\n```\n1. Call ZENDESK_SEARCH_ZENDESK_USERS with query (name or email)\n2. Extract user ID from results\n3. Use user ID as assignee_id in ticket creation/update\n```\n\n## Known Pitfalls\n\n**Tags Behavior**:\n- Tags on update REPLACE all existing tags\n- Always fetch current tags first and merge before updating\n- Tags are lowercase, no spaces (use underscores)\n\n**Safe Updates**:\n- Use `safe_update: true` with `updated_stamp` (ISO 8601) to prevent conflicts\n- Returns 409 if ticket was modified since the stamp\n\n**Deletion**:\n- Ticket deletion is permanent and irreversible\n- Consider setting status to 'closed' instead of deleting\n- Deleted tickets cannot be recovered via API\n\n**Rate Limits**:\n- Default: 400 requests per minute\n- Varies by plan tier\n- 429 responses include Retry-After header\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List tickets | ZENDESK_LIST_ZENDESK_TICKETS | page, per_page, sort_by |\n| Get ticket | ZENDESK_GET_ZENDESK_TICKET_BY_ID | ticket_id |\n| Create ticket | ZENDESK_CREATE_ZENDESK_TICKET | subject, description, priority |\n| Update ticket | ZENDESK_UPDATE_ZENDESK_TICKET | ticket_id, status, tags |\n| Reply to ticket | ZENDESK_REPLY_ZENDESK_TICKET | ticket_id, body, public |\n| Delete ticket | ZENDESK_DELETE_ZENDESK_TICKET | ticket_id |\n| Search users | ZENDESK_SEARCH_ZENDESK_USERS | query |\n| Create user | ZENDESK_CREATE_ZENDESK_USER | name, email |\n| My profile | ZENDESK_GET_ABOUT_ME | (none) |\n| List orgs | ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS | page, per_page |\n| Get org | ZENDESK_GET_ZENDESK_ORGANIZATION | organization_id |\n| Create org | ZENDESK_CREATE_ZENDESK_ORGANIZATION | name |\n| Update org | ZENDESK_UPDATE_ZENDESK_ORGANIZATION | organization_id, name |\n| Count orgs | ZENDESK_COUNT_ZENDESK_ORGANIZATIONS | (none) |\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":["zendesk","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-zendesk-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/zendesk-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 · 34404 github stars · SKILL.md body (8,290 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-22T00:52:01.855Z","embedding":null,"createdAt":"2026-04-18T21:47:58.718Z","updatedAt":"2026-04-22T00:52:01.855Z","lastSeenAt":"2026-04-22T00:52:01.855Z","tsv":"'/mcp':76 '1':96,143,162,190,301,471,577,688,802,866 '100':198,238,808 '2':108,173,281,309,483,586,698,877 '3':116,319,453,596,707,883 '4':131,328,557,715 '400':968 '409':935 '429':976 '5':672,723 '8601':930 'action':850,1124 'activ':48,121,136 'add':73,90,437,463,488 'address':628 'admin':635,665 'agent':370,534,571,633,663 'also':552 'alway':15,58,904 'api':86,964 'applic':1118 'array':381,756,761 'asc':211 'ask':1162 'assign':374,837,865 'assigne':368,888 'associ':758,794 'audit':269 'auth':125,130 'authent':522,602 'author':515,517 'autom':3,4,23,27 'automat':792 'avail':47,101 'base':191,231,803 'becom':348 'behavior':662,783,896 'bodi':345,501,548,1039 'boolean':506 'boundari':1170 'call':59,109,867 'cannot':423,443,859,960 'caus':773 'check':232,809 'clarif':1164 'clear':1137 'client':83 'close':362,441,830,856,858,954 'comment':267,350,438,464 'common':795 'complet':128 'composio':10,31 'concurr':414 'configur':84 'confirm':103,132 'conflict':416,933 'connect':43,50,54,112,118,133 'consid':950 'content':504 'core':141 'count':725,730,819,1105,1108 'creat':203,282,292,311,314,446,568,588,591,650,682,709,712,1011,1014,1056,1059,1089,1092 'creation':347,431,440,623,740,774 'creation/update':892 'criteria':1173 'current':20,66,401,479,906 'custom':844 'default':520,535,967 'delet':251,265,330,333,417,943,945,957,958,1041,1044 'desc':213 'describ':1125,1141 'descript':343,426,1018 'detail':183,747,749 'domain':754,759,786 'duplic':771 'email':541,613,624,627,638,656,876,1063 'end':573,631 'end-us':572,630 'endpoint':92,799 'entir':398 'environ':1153 'environment-specif':1152 'error':775 'etc':615 'execut':1120 'exist':297,396,655,659,780,902 'expert':1158 'extract':878 'fals':511,527 'featur':671 'fetch':905 'field':202,326,820 'filter':155 'find':306,566 'first':18,63,349,908 'follow':122,449 'follow-up':448 'full':619 'fuzzi':645 'get':65,70,175,180,259,273,473,478,598,601,690,700,703,728,1001,1004,1067,1074,1081,1084 'get/update':746 'give':821 'header':982 'high':353 'hold':360,832,846 'html':544 'id':179,215,217,261,275,369,372,376,379,386,388,477,495,497,516,519,742,744,880,886,889,1008,1010,1027,1038,1048,1088,1103 'incid':365 'includ':271,978 'info':604 'input':1167 'instead':452,955 'intern':513,529,752,849 'irrevers':421,949 'iso':929 'iter':242 'key':87,185,337,492,606,732,988 'known':893 'last':817 'lifecycl':825 'limit':966,1129 'line':342 'link':126 'list':144,164,167,222,257,279,681,694,798,990,993,1071 'low':355 'lowercas':915 'manag':53,111,558,673,684 'match':611,649,1138 'max':197,807 'maximum':237 'may':646,667 'mcp':9,26,37,40,72,79,99 'mean':816 'merg':399,910 'minut':971 'miss':1175 'modif':415 'modifi':296,861,939 'must':41,768 'name':612,616,620,734,736,755,767,772,787,874,1062,1095,1104 'need':88 'new':293,316,357,593,826,833 'next':233,247,810 'none':1070,1111 'normal':354 'note':514,530,751,753 'null':250,815 'number':189,245 'offset':230 'offset-bas':229 'one':298 'open':358,827,836 'oper':29 'option':184,327,336,595,605,706,714,722,731 'order':210 'org':1072,1082,1090,1097,1106 'organ':13,674,685,693,696,702,705,711,713,719,721,727,735,741,743,748,766,1077,1086,1087,1094,1101,1102,1110 'output':1147 'overview':1128 'page':187,188,193,196,224,226,234,241,244,248,801,806,811,818,996,998,1078,1080 'pagin':171,227,797 'param':989 'paramet':186,338,493,607,733 'partial':648 'pattern':796 'pend':359,828,841 'per':192,195,225,240,805,970,997,1079 'perman':419,857,947 'permiss':1168 'phone':614 'pitfal':221,391,524,641,765,894 'plan':670,974 'prerequisit':38,308,482 'preserv':404 'prevent':413,932 'prioriti':207,351,1019 'problem':364 'profil':1065 'public':505,509,526,537,1040 'queri':608,873,1055 'question':366 'quick':983 'rate':965 'recov':425,962 'refer':984 'reopen':855 'replac':395,779,900 'repli':14,433,454,466,485,499,502,510,538,550,1030,1034 'reply/comment':490 'request':375,377,543,969 'requester/assignee':307 'requir':172,318,491,585,621,668,697,738,1166 'resolv':852 'respond':107 'respons':236,280,814,845,977 'result':194,239,823,882 'retri':980 'retriev':220 'retry-aft':979 'return':124,255,263,647,657,934 'review':1159 'role':629,666 'rube':8,25,36,39,44,52,60,71,98,104,110 'rube.app':75 'rube.app/mcp':74 'run':138 'safe':407,920,923 'safeti':1169 'schema':21,68 'scope':1140 'search':16,45,61,105,146,157,303,579,582,609,643,863,869,1049,1052 'send':540 'sequenc':161,300,470,576,687 'server':80 'set':525,951 'setup':69 'show':135 'simultan':556 'sinc':940 'singl':219 'skill':1116,1132 'skill-zendesk-automation' 'slug':987 'solv':361,829,851 'sort':199,201,209,999 'source-sickn33' 'space':917 'specif':181,669,704,1154 'stamp':411,928,942 'state':481 'status':134,208,264,356,555,952,1028 'stop':1160 'string':384,610,764 'subject':339,341,1017 'substitut':1150 'success':1172 'support':158,546 'tag':380,383,392,397,402,760,763,776,781,895,897,903,907,913,1029 'task':6,367,985,1136 'test':1156 'text':503,549,750 'ticket':11,147,159,166,169,177,182,214,216,252,266,285,294,313,317,323,325,332,335,340,344,385,387,422,435,442,451,456,468,475,480,487,494,496,554,785,824,835,891,937,944,959,991,995,1002,1006,1009,1012,1016,1021,1025,1026,1032,1036,1037,1042,1046,1047 'tier':975 'tool':17,46,62,67,106,160,299,469,575,686,986 'toolkit':34,56,114 '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':729,822 'treat':1145 'true':507,925 'type':363 'unassign':834 'underscor':919 'uniqu':737,770 'updat':205,284,321,324,394,408,410,445,553,717,720,778,899,912,921,924,927,1020,1023,1096,1099 'update/delete':390 'upsert':661 'urgent':352 'url':812 'use':150,223,258,288,406,429,432,459,562,677,790,800,884,918,922,1114,1130 'user':12,151,289,305,371,378,460,518,523,559,563,570,574,581,584,590,594,603,617,625,632,642,652,660,678,793,862,871,879,885,1050,1054,1057,1061 'v':831 'valid':1155 'vari':972 'verifi':97,636,640 'via':7,24,35,51,963 'view':154 'visibl':531 'wait':842,847 'want':152,290,461,564,679 'whether':637 'work':95,839 'workflow':140,142,1122 'zendesk':2,5,22,28,33,49,57,115,129,163,165,174,176,302,304,310,312,320,322,329,331,434,472,474,484,486,569,578,580,587,589,597,689,692,699,701,708,710,716,718,724,726,868,870,992,994,1003,1005,1013,1015,1022,1024,1033,1035,1043,1045,1051,1053,1058,1060,1066,1073,1076,1083,1085,1091,1093,1098,1100,1107,1109 'zendesk-autom':1","prices":[{"id":"1e818cae-720e-489a-8e8f-75a6efee4edc","listingId":"59eeaa1c-3a26-4f35-b3b6-cac5ad48e7f5","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:47:58.718Z"}],"sources":[{"listingId":"59eeaa1c-3a26-4f35-b3b6-cac5ad48e7f5","source":"github","sourceId":"sickn33/antigravity-awesome-skills/zendesk-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/zendesk-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:47:58.718Z","lastSeenAt":"2026-04-22T00:52:01.855Z"}],"details":{"listingId":"59eeaa1c-3a26-4f35-b3b6-cac5ad48e7f5","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"zendesk-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34404,"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-21T16:43:40Z","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":"d58ba24237b8f4906110a1c2a89f4d9bfbc375c1","skill_md_path":"skills/zendesk-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/zendesk-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"zendesk-automation","description":"Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/zendesk-automation"},"updatedAt":"2026-04-22T00:52:01.855Z"}}