amnafarzy/ravie/observability-incident-loop
Claude Code and agent skill by amnafarzy/ravie
- community
Checking that the SKILL.md file is still in the repository.
Use this ONLY for production failures: Vercel production errors, Supabase outages, Actions failing on main, automation crashes, user-reported live bugs. Runs the incident loop: stabilize, diagnose, fix, prevent. Local, preview, or pre-merge failures → debug-root-cause.
Install
npx vskill@latest install amnafarzy/ravie/observability-incident-loopSKILL.md
The same SKILL.md was published earlier as amnafarzy/ravie/observability-incident-loop.
observability-incident-loop
Production incident → triage → fix → Linear task → runbook update. The structured response when something breaks in production.
Purpose
Convert failures across Vercel, Supabase, GitHub Actions, and VPS/automation into a structured incident response: triage, fix, document, and prevent recurrence.
Process
1. Triage (5 minutes max)
Determine severity:
- P1 — Service down: Users can't access the product. Fix now.
- P2 — Feature broken: Core feature doesn't work. Fix within hours.
- P3 — Degraded: Something is slow or intermittent. Fix within 24h.
- P4 — Warning: Logs show concerning patterns. Investigate this week.
2. Gather evidence
Before fixing anything:
Capture: exact error messages, timestamps, affected users/routes, recent deployments.
3. Identify root cause
Route to debug-root-cause if the cause isn't immediately obvious. Common patterns:
- Recent deploy introduced a bug → check
git log --oneline -5 - Supabase migration broke something → check latest migration
- Env var missing in production → check
.env.examplevs deployed env - VPS job failed silently → check job logs and retry count
4. Fix
Apply minimal fix to restore service. Don't refactor during an incident.
5. Document
Create a Linear issue with:
6. Update runbook
If a runbook exists for this system, update it with the new failure mode and fix. If no runbook exists and the system has failed twice, create one.
7. Prevent recurrence
- If caused by a missing check → add a hook or CI step
- If caused by a missing test → add the test
- If caused by manual error → add automation
- If caused by a monitoring gap → add alerting
Output format
Hard rules
- Never fix without capturing evidence first — you need the logs before the fix overwrites them
- Never refactor during an incident — minimal fix to restore service, clean up later
- Never close an incident without a prevention step — "it's fixed" is not enough
- Always create a Linear issue for P1-P3 incidents
- Always update or create a runbook after the second failure of the same type
Connects to
debug-root-cause— for non-obvious root causesautomation-sre— for VPS/automation job failuressupabase-guardian— for database-related incidentsvercel-preview-qa— for deployment-related incidentsnotion-brain— for storing runbookslinear-operator— for creating incident issues
Common failure modes
Fixing before capturing evidence — You restart the service, the error logs are gone. Always capture first.
No prevention step — "We fixed the bug" but didn't add a test, hook, or check. The same bug returns in 3 weeks.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/observability-incident-loop/SKILL.md
Popularity
- Repository stars
- 3
- 7-day trend score
- 7
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 9 Oct 2026, a month ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/amnafarzy/ravie/observability-incident-loop)