| name | sentry |
| description | Sentry issue triage and investigation with automatic cross-linking. Handles issue investigation, AI analysis via Seer, and integration with Linear for tracking fixes. Use when triaging Sentry errors, investigating sentry.io URLs, or creating Linear issues from Sentry. |
| argument-hint | [sentry-url | analyze <url> | linear <url> | triage --limit N] |
Sentry Issue Management
Triage, investigate, and resolve Sentry issues with enforced cross-linking to Linear and GitHub.
Organization: intexuraos-dev-pbuchman
Usage
/sentry # NON-INTERACTIVE: Triage unresolved issues
/sentry <sentry-url> # Investigate specific issue
/sentry INT-123 # Find Sentry issues linked to Linear issue
/sentry triage --limit 5 # Batch triage with limit
/sentry analyze <sentry-url> # AI-powered root cause analysis via Seer
Core Mandates
- Fail Fast: If Sentry, Linear, GitHub CLI, or GCloud are unavailable, STOP immediately
- No Guessing: Surface-level fixes without identifying the source of corruption are FORBIDDEN
- Cross-Linking: Every Sentry issue MUST be linked to a Linear issue and GitHub PR
- Documentation in PR: Reasoning belongs in PR descriptions, not code comments
- CI Gate:
pnpm run ci:tracked MUST pass before PR creation
Invocation Detection
The skill automatically detects intent from input:
Tool Verification (Fail Fast)
Before ANY operation, verify all required tools:
| Tool | Verification Command | Purpose |
|---|
| Sentry MCP | mcp__sentry__whoami | Issue management |
| Linear MCP | mcp__linear__list_teams | Issue tracking |
| GitHub CLI | gh auth status | PR creation |
| GCloud | Service account verification | Firestore access |
GCloud Verification
Service account key location: ~/.config/gcloud/sa-key.json
- Check if credentials file exists
- If
gcloud auth list shows no active account, activate service account
- Verify authentication
You are NEVER "unauthenticated" if the service account key file exists.
Failure Handling
If ANY required tool is unavailable, ABORT immediately:
ERROR: /sentry cannot proceed - <tool-name> unavailable
Required for: <purpose>
Fix: <fix-command>
Aborting.
Configured Projects
Issues are fetched from these Sentry projects:
intexuraos-development (backend services)
intexuraos-web-development (web app)
Cross-Linking Protocol (Critical)
Every Sentry issue must be traceable across all systems:
| Direction | Method |
|---|
| Sentry → Linear | Comment on Sentry with Linear issue link |
| Linear → Sentry | [sentry] <title> naming + link in description |
| Linear → GitHub | PR title contains INT-XXX |
| GitHub → Linear | Fixes INT-XXX in PR body |
| GitHub → Sentry | Sentry link in PR description |
References