helpdesk-automation — скилл для Claude Code
Скилл helpdesk-automation автоматизирует чтение тикетов, сохранённых представлений и шаблонов HelpDesk через Rube MCP и Composio. Пригодится поддержке для обзора очереди.
MIT 124 установок ★ 3 785 обновлён 2026-10-25
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-codeЧто делает helpdesk-automation
Скилл подключает ИИ-агента к операциям службы поддержки HelpDesk через инструментарий Composio и Rube MCP. С его помощью агент просматривает списки обращений, переключается между папками tickets, archive, trash или spam, а также запрашивает настроенные агентами фильтры (views), шаблоны готовых ответов и кастомные поля учётной записи.
Для навигации по тикетам используется курсорная пагинация: агент передаёт пары значений времени и ID (next.value и next.ID). Поиск между разными папками одновременно не поддерживается, поэтому каждый каталог проверяется отдельно. Сортировка доступна по дате создания, обновления или последнего сообщения с лимитом до 100 записей на страницу.
Текущий набор инструментов работает только на чтение: создание и редактирование тикетов или изменение представлений через этот скилл недоступны. Без предварительно подключённого Rube MCP по адресу https://rube.app/mcp и активной связки в RUBE_MANAGE_CONNECTIONS вызовы инструментов завершатся ошибкой.
Какие задачи решает
- выгрузить список активных тикетов с сортировкой по дате обновления
- просмотреть готовые шаблоны ответов службы поддержки перед ответом клиенту
- проверить структуру кастомных полей тикетов для синхронизации данных
- пройтись по архиву или спаму с курсорной пагинацией
Примеры запросов агенту
- Покажи последние 20 активных тикетов из HelpDesk с сортировкой по дате последнего сообщения
- Запроси список готовых шаблонов ответов (canned responses) из HelpDesk
- Выведи схему кастомных полей, настроенных в нашем аккаунте HelpDesk
Как установить helpdesk-automation
1Через Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-code2Вручную: положить файлы
~/.claude/skills/helpdesk-automation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/helpdesk-automation/
1Через Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a codex2Вручную: положить файлы
.agents/skills/helpdesk-automation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a cursor2Вручную: положить файлы
.cursor/skills/helpdesk-automation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/helpdesk-automation2Вручную: положить файлы
.github/skills/helpdesk-automation/SKILL.md1Через Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a gemini-cli2Командой платформы
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/helpdesk-automationВручную: положить файлы
.devin/skills/helpdesk-automation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о helpdesk-automation
Как установить helpdesk-automation в Claude Code?
Выполните команду npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-code.
Что нужно настроить перед запуском скилла?
В клиент нужно добавить MCP-сервер по адресу https://rube.app/mcp, вызвать RUBE_MANAGE_CONNECTIONS для тулкита helpdesk и пройти авторизацию по полученной ссылке.
Можно ли через этот скилл создавать тикеты или менять шаблоны?
Нет, инструменты Composio для HelpDesk в этом скилле рассчитаны исключительно на чтение, а фильтры и шаблоны настраиваются только в интерфейсе HelpDesk.
Исходный текст
SKILL.md · MIT
--- 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." requires: mcp: [rube] category: customer-support --- # HelpDesk Automation via Rube MCP Automate HelpDesk ticketing operations through Composio's HelpDesk toolkit via Rube MCP. **Toolkit docs**: [composio.dev/toolkits/helpdesk](https://composio.dev/toolkits/helpdesk) ## Prerequisites - Rube MCP must be connected (RUBE_SEARCH_TOOLS available) - Active HelpDesk connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `helpdesk` - Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas ## Setup **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. 1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds 2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `helpdesk` 3. If connection is not ACTIVE, follow the returned auth link to complete HelpDesk authentication 4. Confirm connection status shows ACTIVE before running any workflows ## Core Workflows ### 1. List and Browse Tickets **When to use**: User wants to retrieve, browse, or paginate through support tickets **Tool sequence**: 1. `HELPDESK_LIST_TICKETS` - List tickets with sorting and pagination [Required] **Key parameters**: - `silo`: Ticket folder - 'tickets', 'archive', 'trash', or 'spam' (default: 'tickets') - `sortBy`: Sort field - 'createdAt', 'updatedAt', or 'lastMessageAt' (default: 'createdAt') - `order`: Sort direction - 'asc' or 'desc' (default: 'desc') - `pageSize`: Results per page, 1-100 (default: 20) - `next.value`: Timestamp cursor for forward pagination - `next.ID`: ID cursor for forward pagination - `prev.value`: Timestamp cursor for backward pagination - `prev.ID`: ID cursor for backward pagination **Pitfalls**: - Pagination uses cursor-based approach with timestamp + ID pairs - Forward pagination requires both `next.value` and `next.ID` from previous response - Backward pagination requires both `prev.value` and `prev.ID` - `silo` determines which folder to list from; default is active tickets - `pageSize` max is 100; default is 20 - Archived and trashed tickets are in separate silos ### 2. Manage Ticket Views **When to use**: User wants to see saved agent views for organizing tickets **Tool sequence**: 1. `HELPDESK_LIST_VIEWS` - List all agent views [Required] **Key parameters**: (none required) **Pitfalls**: - Views are predefined saved filters configured by agents in the HelpDesk UI - View definitions include filter criteria that can be used to understand ticket organization - Views cannot be created or modified via API; they are managed in the HelpDesk UI ### 3. Use Canned Responses **When to use**: User wants to list available canned (template) responses for tickets **Tool sequence**: 1. `HELPDESK_LIST_CANNED_RESPONSES` - Retrieve all predefined reply templates [Required] **Key parameters**: (none required) **Pitfalls**: - Canned responses are predefined templates for common replies - They may include placeholder variables that need to be filled in - Canned responses are managed through the HelpDesk UI - Response content may include HTML formatting ### 4. Inspect Custom Fields **When to use**: User wants to view custom field definitions for the account **Tool sequence**: 1. `HELPDESK_LIST_CUSTOM_FIELDS` - List all custom field definitions [Required] **Key parameters**: (none required) **Pitfalls**: - Custom fields extend the default ticket schema with organization-specific data - Field definitions include field type, name, and validation rules - Custom fields are configured in the HelpDesk admin panel - Field values appear on tickets when the field has been populated ## Common Patterns ### Ticket Browsing Pattern ``` 1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy 2. Process the returned page of tickets 3. Extract next.value and next.ID from the response 4. Call HELPDESK_LIST_TICKETS with those cursor values for next page 5. Continue until no more cursor values are returned ``` ### Ticket Folder Navigation ``` Active tickets: silo='tickets' Archived: silo='archive' Trashed: silo='trash' Spam: silo='spam' ``` ### Cursor-Based Pagination ``` Forward pagination: - Use next.value (timestamp) and next.ID from response - Pass as next.value and next.ID parameters in next call Backward pagination: - Use prev.value (timestamp) and prev.ID from response - Pass as prev.value and prev.ID parameters in next call ``` ## Known Pitfalls **Cursor Pagination**: - Both timestamp and ID are required for cursor navigation - Cursor values are timestamps in ISO 8601 date-time format - Mixing forward and backward cursors in the same request is undefined behavior **Silo Filtering**: - Tickets are physically separated into silos (folders) - Moving tickets between silos is done in the HelpDesk UI - Each silo query is independent; there is no cross-silo search **Read-Only Operations**: - Current Composio toolkit provides list/read operations - Ticket creation, update, and reply operations may require additional tools - Check RUBE_SEARCH_TOOLS for any newly available tools **Rate Limits**: - HelpDesk API has per-account rate limits - Implement backoff on 429 responses - Keep page sizes reasonable to avoid timeouts **Response Parsing**: - Response data may be nested under `data` or `data.data` - Parse defensively with fallback patterns - Ticket IDs are strings ## Quick Reference | Task | Tool Slug | Key Params | |------|-----------|------------| | List tickets | HELPDESK_LIST_TICKETS | silo, sortBy, order, pageSize | | List views | HELPDESK_LIST_VIEWS | (none) | | List canned responses | HELPDESK_LIST_CANNED_RESPONSES | (none) | | List custom fields | HELPDESK_LIST_CUSTOM_FIELDS | (none) | --- *Powered by [Composio](https://composio.dev)*
© davepoon · MIT · davepoon/buildwithclaude