SKILL.md
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:trackedMUST pass before PR creation
Invocation Detection
The skill automatically detects intent from input:
| Input Pattern | Type | Workflow |
|---|---|---|
/sentry (no args) |
Batch Triage | [triage-batch.md](workflows/triage-batch.md) |
/sentry <sentry-url> |
Single Issue | [triage-issue.md](workflows/triage-issue.md) |
/sentry analyze <url> |
Seer Analysis | [analyze-with-seer.md](workflows/analyze-with-seer.md) |
/sentry linear <sentry-url> |
Create Linear | [create-linear-issue.md](workflows/create-linear-issue.md) |
/sentry triage --limit N |
Limited Batch | [triage-batch.md](workflows/triage-batch.md) |
Tool Verification (Fail Fast)
Before ANY operation, verify all required tools:
| Tool | Verification Command | Purpose |
|---|---|---|
| Sentry MCP | mcpsentrywhoami |
Issue management |
| Linear MCP | mcplinearlist_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 listshows 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
- Workflows: [
workflows/](workflows/) - Templates: [
templates/](templates/) - Reference: [
reference/](reference/)