메뉴
Interact with Zendesk API - read tickets, test connection, export data
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Check Copilot Review Comments. Fetches, adversarially verifies, and resolves Copilot code-review comments on the current PR, then drives an automated re-review loop (re-request → watch → verify → fix → converge). Use when the user asks to "check copilot comments", "what did copilot say", "copilot review", or "/copilot-check".
Execute a GitHub HLR (High-Level Requirement) issue end to end — first-cut breakdown, specialist co-production and synthesis, /plan:tasks → sub-issues, parallel build, QA verification, security gate, and PR. Use when the user runs `/do-hlr <issue#>` or asks to implement/execute an HLR. Runs the full pipeline for substantial HLRs and a lean path for small ones.
Reads emails from Gmail account. Use when the user asks to "look at emails", "check emails from [sender]", "read recent emails", or "/read-email". Fetches emails with full body content for analysis.
Checks documentation consistency across the repository. Use when user asks to "check consistency", "are the documents consistent", "is everything aligned", "verify documentation", or "/repo-consistency".
Rewrites git history to permanently remove sensitive data. DESTRUCTIVE OPERATION - rewrites commit history. Use when user asks to "purge secrets from history", "remove sensitive data from git history", "clean git history", or "/repo-security-purge". Requires explicit confirmation.
Scans a repository for sensitive information and security vulnerabilities. Use when the user asks to "scan for security issues", "check for sensitive data", "repo security scan", "make sure this repo has no sensitive information", "security audit", "scan history for secrets", or "/repo-security-scan".
| name | zendesk |
| description | Interact with Zendesk API - read tickets, test connection, export data |
| allowed-tools | ["Bash","Read","Write"] |
Tools for interacting with the Zendesk API.
Set your Zendesk credentials as environment variables:
export ZENDESK_SUBDOMAIN=yourcompany # Your Zendesk subdomain
export ZENDESK_EMAIL=you@example.com # Your Zendesk email
export ZENDESK_API_TOKEN=your_token # API token from Zendesk Admin
Get your API token from: Zendesk Admin > Apps and integrations > APIs > Zendesk API
Enterprise plan (700 requests/minute). The skills include automatic retry with exponential backoff for rate limit handling.
Test your Zendesk API connection and credentials.
/zendesk:test
Verifies that your credentials are valid by fetching your user profile.
Success output:
✓ Connected to Zendesk successfully!
Subdomain: yourcompany
User: John Smith (john@example.com)
Role: admin
On error: Shows helpful messages for missing credentials, invalid tokens, or network issues.
Read a Zendesk ticket by ID, displaying ticket details and comments.
/zendesk:read 12345
Fetches the ticket and displays:
Example output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Ticket #12345: Help with login issue
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status: open Priority: high
Created: 2026-01-20 14:30 Updated: 2026-01-24 09:15
Requester: Jane Customer <jane@example.com>
Assignee: Support Agent <support@company.com>
List all Zendesk macros with their actions.
/zendesk:macros # List all macros
/zendesk:macros --active # Show only active macros
/zendesk:macros --json # Output raw JSON for import processing
Options:
--active - Show only active macros--inactive - Show only inactive macros--json - Output raw JSON to stdout--output FILE - Export to file (.json or .yaml/.yml)File Export:
/zendesk:macros --output macros.json # Export all to JSON
/zendesk:macros --active --output active.yaml # Export active to YAML
Exported files include metadata:
{
"exported_at": "2026-01-24T10:30:00Z",
"count": 47,
"macros": [...]
}
Example output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Zendesk Macros (47 total: 42 active, 5 inactive)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Active] #12345 - Close and thank customer
Actions: Set status=closed, Add comment: "Thank you for..."
[Active] #12346 - Request more information
Actions: Set status=pending, Add comment: "Could you please..."
[Inactive] #12347 - Old workflow macro
Actions: Set status=open, Set tags: legacy
Export tickets using the Incremental Exports API for migration validation.
/zendesk:sample-export # Export 100 tickets from last 30 days
/zendesk:sample-export --limit 50 # Export 50 tickets
/zendesk:sample-export --since 2026-01-01 # From specific date
Options:
--limit N - Maximum tickets to export (default: 100)--since DATE - Start date in YYYY-MM-DD format (default: 30 days ago)--output FILE - Output file (default: sample-export-YYYYMMDD.json)--validate - Run data completeness validation after export--resume - Resume from last saved cursor file--resume-from FILE - Resume from specific cursor fileOutput files:
sample-export-YYYYMMDD.json - Tickets with metadatasample-export-YYYYMMDD.cursor - Cursor for resumability testingExample output:
Exporting tickets via Incremental API...
Start date: 2026-01-01
Limit: 100 tickets
Fetching page 1... 100 tickets
✓ Exported 100 tickets to sample-export-20260124.json
Cursor saved to: sample-export-20260124.cursor
Date range: 2026-01-01 to 2026-01-24
Status: More tickets available (limit reached)
Validation mode (--validate):
Checks data completeness for migration planning:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Data Completeness Validation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Tickets exported: 100
Comments:
✓ All 100 tickets have comments fetched
Total comments: 847
Avg per ticket: 8.5
Attachments:
✓ 156 attachments found
✓ All 156 URLs verified accessible
Custom Fields:
✓ 12 custom field IDs found with values
Tickets with custom field data: 85 of 100
✓ No issues found - data appears complete
Resume mode (--resume):
Continue an interrupted export from the saved cursor:
/zendesk:sample-export --limit 50 # Export first 50
/zendesk:sample-export --limit 50 --resume # Export next 50
/zendesk:sample-export --resume-from sample-export.cursor # From specific cursor