claude/skills/sentry-fix/SKILL.md
Find the highest-frequency unresolved Sentry error for the VAT & Invoicing or Billing team, understand its root cause, create a Jira ticket in the APP project, implement a fix, and open a draft PR. Use when asked to "fix sentry issues", "triage sentry errors", "look at sentry", "what's broken in sentry", "create a fix for a sentry issue", or "sentry triage". Runs the full flow autonomously in the background.
npx skillsauth add iainmcl/dotfiles sentry-fixInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
End-to-end flow: find the top Sentry error for the team → understand root cause → create Jira ticket → implement fix → open draft PR.
Ask the user one question: which repo should the fix go into? (full GitHub path, e.g. travelperk/billing-service)
If the user has already specified this, skip the question.
Tell the user: "Running in the background — I'll let you know when the PR is ready."
Then spawn a background agent with the full instructions below. Pass through the repo name.
Use the Sentry MCP to list unresolved issues for the VAT & Invoicing / Billing team. Filter to:
VAT & Invoicing or BillingTake the single highest-frequency issue.
Capture:
Read the stack trace carefully. Identify:
Check out the relevant source files in the repo to confirm your reading of the bug. Don't guess — read the actual code before proposing a fix.
gh repo clone <repo> /tmp/sentry-fix-<issue-id> 2>/dev/null || true
Use the Atlassian MCP (createJiraIssue) to create a bug ticket:
[Sentry] <concise description of the error>## Sentry issue
<sentry URL>
Frequency: <event count> events, <affected users> users affected
First seen: <date> | Last seen: <date>
## Root cause
<your analysis — file, line, why it happens>
## Stack trace (excerpt)
<most relevant frames>
Note the ticket number (e.g. APP-110486) — you'll need it for the branch name and PR.
On a new branch named APP-<ticket-number>-<short-description> (e.g. APP-110486-fix-null-invoice-id):
If you're not confident the fix is correct (e.g. the bug requires context you can't determine from the code alone), implement the most likely fix and flag the uncertainty in the PR description.
gh pr create --draft \
--title "fix: <description> (APP-<ticket-number>)" \
--body "<body>"
PR body should include:
## What
<one sentence: what bug this fixes>
## Why
<root cause in plain English — what condition triggered the error>
## Sentry
<sentry URL> — <event count> events, <N> users affected
## Jira
https://travelperk.atlassian.net/browse/APP-<ticket-number>
## Fix
<brief explanation of the change and why it works>
## Risks
<anything uncertain, edge cases to watch, or areas where a reviewer should pay extra attention>
Sandbox note: All
ghcommands requiredangerouslyDisableSandbox: true— the sandbox breaks TLS verification for GitHub API calls.
Reply to the user with:
development
Run a weekly achievement review - pulls from Jira, GitHub, and Slack to capture what you shipped in the last week, maps achievements to your 2026 goals, and appends impact-focused entries to your brag doc. Use when asked to "do a weekly review", "capture this week's wins", "update my brag doc", "what did I ship this week", "record my achievements", "what have I done this week", "add to my performance doc", or anything about tracking weekly progress, brag doc entries, or performance evidence. Trigger even if the user just says "weekly review" or "document what I did".
testing
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
tools
Set up a project update config for the current repo, so that running project-update requires no setup questions. Use when asked to "set up project updates", "configure project update", "initialise project update", or "create a project update config". Run this once per project repo.
development
Generate a concise project status update for product managers, formatted for Slack. Use this skill when asked to write a project update, status report, sprint summary, progress briefing, or team update for PMs or stakeholders. Trigger on phrases like "write a project update", "create a status update for slack", "summarise what happened this week", "what should I tell the PM", "prepare an update for the team", "weekly update", "project status", even if the user doesn't explicitly mention Slack or PMs.