{"id":"9e357ac1-d3a0-447a-bede-ee4cd53b56b5","shortId":"8dXt2x","kind":"skill","title":"helpdesk-automation","tagline":"Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas.","description":"# HelpDesk Automation via Rube MCP\n\nAutomate HelpDesk ticketing operations through Composio's HelpDesk toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active HelpDesk connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `helpdesk`\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 `helpdesk`\n3. If connection is not ACTIVE, follow the returned auth link to complete HelpDesk authentication\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. List and Browse Tickets\n\n**When to use**: User wants to retrieve, browse, or paginate through support tickets\n\n**Tool sequence**:\n1. `HELPDESK_LIST_TICKETS` - List tickets with sorting and pagination [Required]\n\n**Key parameters**:\n- `silo`: Ticket folder - 'tickets', 'archive', 'trash', or 'spam' (default: 'tickets')\n- `sortBy`: Sort field - 'createdAt', 'updatedAt', or 'lastMessageAt' (default: 'createdAt')\n- `order`: Sort direction - 'asc' or 'desc' (default: 'desc')\n- `pageSize`: Results per page, 1-100 (default: 20)\n- `next.value`: Timestamp cursor for forward pagination\n- `next.ID`: ID cursor for forward pagination\n- `prev.value`: Timestamp cursor for backward pagination\n- `prev.ID`: ID cursor for backward pagination\n\n**Pitfalls**:\n- Pagination uses cursor-based approach with timestamp + ID pairs\n- Forward pagination requires both `next.value` and `next.ID` from previous response\n- Backward pagination requires both `prev.value` and `prev.ID`\n- `silo` determines which folder to list from; default is active tickets\n- `pageSize` max is 100; default is 20\n- Archived and trashed tickets are in separate silos\n\n### 2. Manage Ticket Views\n\n**When to use**: User wants to see saved agent views for organizing tickets\n\n**Tool sequence**:\n1. `HELPDESK_LIST_VIEWS` - List all agent views [Required]\n\n**Key parameters**: (none required)\n\n**Pitfalls**:\n- Views are predefined saved filters configured by agents in the HelpDesk UI\n- View definitions include filter criteria that can be used to understand ticket organization\n- Views cannot be created or modified via API; they are managed in the HelpDesk UI\n\n### 3. Use Canned Responses\n\n**When to use**: User wants to list available canned (template) responses for tickets\n\n**Tool sequence**:\n1. `HELPDESK_LIST_CANNED_RESPONSES` - Retrieve all predefined reply templates [Required]\n\n**Key parameters**: (none required)\n\n**Pitfalls**:\n- Canned responses are predefined templates for common replies\n- They may include placeholder variables that need to be filled in\n- Canned responses are managed through the HelpDesk UI\n- Response content may include HTML formatting\n\n### 4. Inspect Custom Fields\n\n**When to use**: User wants to view custom field definitions for the account\n\n**Tool sequence**:\n1. `HELPDESK_LIST_CUSTOM_FIELDS` - List all custom field definitions [Required]\n\n**Key parameters**: (none required)\n\n**Pitfalls**:\n- Custom fields extend the default ticket schema with organization-specific data\n- Field definitions include field type, name, and validation rules\n- Custom fields are configured in the HelpDesk admin panel\n- Field values appear on tickets when the field has been populated\n\n## Common Patterns\n\n### Ticket Browsing Pattern\n\n```\n1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy\n2. Process the returned page of tickets\n3. Extract next.value and next.ID from the response\n4. Call HELPDESK_LIST_TICKETS with those cursor values for next page\n5. Continue until no more cursor values are returned\n```\n\n### Ticket Folder Navigation\n\n```\nActive tickets:  silo='tickets'\nArchived:        silo='archive'\nTrashed:         silo='trash'\nSpam:            silo='spam'\n```\n\n### Cursor-Based Pagination\n\n```\nForward pagination:\n  - Use next.value (timestamp) and next.ID from response\n  - Pass as next.value and next.ID parameters in next call\n\nBackward pagination:\n  - Use prev.value (timestamp) and prev.ID from response\n  - Pass as prev.value and prev.ID parameters in next call\n```\n\n## Known Pitfalls\n\n**Cursor Pagination**:\n- Both timestamp and ID are required for cursor navigation\n- Cursor values are timestamps in ISO 8601 date-time format\n- Mixing forward and backward cursors in the same request is undefined behavior\n\n**Silo Filtering**:\n- Tickets are physically separated into silos (folders)\n- Moving tickets between silos is done in the HelpDesk UI\n- Each silo query is independent; there is no cross-silo search\n\n**Read-Only Operations**:\n- Current Composio toolkit provides list/read operations\n- Ticket creation, update, and reply operations may require additional tools\n- Check RUBE_SEARCH_TOOLS for any newly available tools\n\n**Rate Limits**:\n- HelpDesk API has per-account rate limits\n- Implement backoff on 429 responses\n- Keep page sizes reasonable to avoid timeouts\n\n**Response Parsing**:\n- Response data may be nested under `data` or `data.data`\n- Parse defensively with fallback patterns\n- Ticket IDs are strings\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List tickets | HELPDESK_LIST_TICKETS | silo, sortBy, order, pageSize |\n| List views | HELPDESK_LIST_VIEWS | (none) |\n| List canned responses | HELPDESK_LIST_CANNED_RESPONSES | (none) |\n| List custom fields | HELPDESK_LIST_CUSTOM_FIELDS | (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":["helpdesk","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-helpdesk-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/helpdesk-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 · 34768 github stars · SKILL.md body (6,021 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-23T18:51:26.426Z","embedding":null,"createdAt":"2026-04-18T21:38:23.926Z","updatedAt":"2026-04-23T18:51:26.426Z","lastSeenAt":"2026-04-23T18:51:26.426Z","tsv":"'-100':216 '/mcp':84 '1':104,151,171,215,316,389,457,519 '100':285 '2':116,297,529 '20':218,288 '3':124,370,536 '4':139,438,544 '429':730 '5':556 '8601':640 'account':454,724 'action':809 'activ':56,129,144,280,568 'add':81,98 'addit':706 'admin':501 'agent':309,322,337 'alway':22,66 'api':94,362,720 'appear':505 'applic':803 'approach':249 'archiv':188,289,572,574 'asc':206 'ask':847 'auth':133 'authent':138 'autom':3,4,30,34 'avail':55,109,381,715 'avoid':737 'backoff':728 'backward':235,241,264,603,648 'base':248,583 'behavior':656 'boundari':855 'brows':154,163,517 'call':67,117,520,545,602,620 'can':16,372,382,392,405,424,782,786 'cannot':356 'check':708 'clarif':849 'clear':822 'client':91 'common':411,514 'complet':136 'composio':10,39,693 'configur':19,92,335,497 'confirm':111,140 'connect':51,58,62,120,126,141 'content':433 'continu':557 'core':149 'creat':358 'createdat':197,202 'creation':699 'criteria':346,858 'cross':685 'cross-silo':684 'current':27,74,692 'cursor':221,227,233,239,247,551,561,582,623,632,634,649 'cursor-bas':246,581 'custom':20,440,449,460,464,473,494,790,794 'data':484,742,747 'data.data':749 'date':642 'date-tim':641 'default':192,201,209,217,278,286,477 'defens':751 'definit':343,451,466,486 'desc':208,210 'describ':810,826 'desir':525 'determin':272 'direct':205 'done':671 'endpoint':100 'environ':838 'environment-specif':837 'execut':805 'expert':843 'extend':475 'extract':537 'fallback':753 'field':21,196,441,450,461,465,474,485,488,495,503,510,791,795 'fill':422 'filter':334,345,658 'first':25,71 'folder':186,274,566,665 'follow':130 'format':437,644 'forward':223,229,254,585,646 'get':73,78 'helpdesk':2,5,29,35,41,57,65,123,137,172,317,340,368,390,430,458,500,521,546,674,719,768,777,784,792 'helpdesk-autom':1 'html':436 'id':226,238,252,628,756 'implement':727 'includ':344,415,435,487 'independ':680 'input':852 'inspect':439 'iso':639 'keep':732 'key':95,182,325,400,468,764 'known':621 'lastmessageat':200 'limit':718,726,814 'link':134 'list':11,152,173,175,276,318,320,380,391,459,462,522,547,766,769,775,778,781,785,789,793 'list/read':696 'manag':13,61,119,298,365,427 'match':823 'max':283 'may':414,434,704,743 'mcp':9,33,45,48,80,87,107 'miss':860 'mix':645 'modifi':360 'move':666 'must':49 'name':490 'navig':567,633 'need':96,419 'nest':745 'newli':714 'next':554,601,619 'next.id':225,260,540,591,598 'next.value':219,258,538,588,596 'none':327,402,470,780,788,796 'oper':37,691,697,703 'order':203,773 'organ':312,354,482 'organization-specif':481 'output':832 'overview':813 'page':214,533,555,733 'pages':211,282,774 'pagin':165,180,224,230,236,242,244,255,265,584,586,604,624 'pair':253 'panel':502 'param':765 'paramet':183,326,401,469,599,617 'pars':740,750 'pass':594,612 'pattern':515,518,754 'per':213,723 'per-account':722 'permiss':853 'physic':661 'pitfal':243,329,404,472,622 'placehold':416 'popul':513 'predefin':332,396,408 'prerequisit':46 'prev.id':237,270,609,616 'prev.value':231,268,606,614 'previous':262 'process':530 'provid':695 'queri':678 'quick':759 'rate':717,725 'read':689 'read-on':688 'reason':735 'refer':760 'repli':397,412,702 'request':653 'requir':181,256,266,324,328,399,403,467,471,630,705,851 'respond':115 'respons':17,263,373,384,393,406,425,432,543,593,611,731,739,741,783,787 'result':212 'retriev':162,394 'return':132,532,564 'review':844 'rube':8,32,44,47,52,60,68,79,106,112,118,709 'rube.app':83 'rube.app/mcp':82 'rule':493 'run':146 'safeti':854 'save':308,333 'schema':28,76,479 'scope':825 'search':23,53,69,113,687,710 'see':307 'separ':295,662 'sequenc':170,315,388,456 'server':88 'setup':77 'show':143 'silo':184,271,296,526,570,573,576,579,657,664,669,677,686,771 'size':734 'skill':801,817 'skill-helpdesk-automation' 'slug':763 'sort':178,195,204 'sortbi':194,528,772 'source-sickn33' 'spam':191,578,580 'specif':483,839 'status':142 'stop':845 'string':758 'substitut':835 'success':857 'support':167 'task':6,761,821 'templat':383,398,409 'test':841 'ticket':12,36,155,168,174,176,185,187,193,281,292,299,313,353,386,478,507,516,523,535,548,565,569,571,659,667,698,755,767,770 'time':643 'timeout':738 'timestamp':220,232,251,589,607,626,637 'tool':24,54,70,75,114,169,314,387,455,707,711,716,762 'toolkit':42,64,122,694 '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' 'trash':189,291,575,577 'treat':830 'type':489 'ui':341,369,431,675 'undefin':655 'understand':352 'updat':700 'updatedat':198 'use':15,158,245,303,350,371,376,444,587,605,799,815 'user':159,304,377,445 'valid':492,840 'valu':504,552,562,635 'variabl':417 'verifi':105 'via':7,31,43,59,361 'view':14,300,310,319,323,330,342,355,448,776,779 'want':160,305,378,446 'work':103 'workflow':148,150,807","prices":[{"id":"119a53ba-22cc-4e31-9997-572bbdba57f9","listingId":"9e357ac1-d3a0-447a-bede-ee4cd53b56b5","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:38:23.926Z"}],"sources":[{"listingId":"9e357ac1-d3a0-447a-bede-ee4cd53b56b5","source":"github","sourceId":"sickn33/antigravity-awesome-skills/helpdesk-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/helpdesk-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:38:23.926Z","lastSeenAt":"2026-04-23T18:51:26.426Z"}],"details":{"listingId":"9e357ac1-d3a0-447a-bede-ee4cd53b56b5","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"helpdesk-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34768,"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-23T06:41:03Z","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":"c089f3ea21e7384dba2746c20045063b39d6aa69","skill_md_path":"skills/helpdesk-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/helpdesk-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"helpdesk-automation","description":"Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/helpdesk-automation"},"updatedAt":"2026-04-23T18:51:26.426Z"}}