SRE Practice Skills
Eight skills with SRE practices: SLOs and error budgets, alerting, incident response, postmortems and production launches
- 66 ★ on the repository
- Last commit
- Apache-2.0
Minimal access
Why this level
- The skills provide instructions and templates, and the `burn_rate.py` script only computes from the numbers given
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/sre-practice-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skills provide instructions and templates, and the `burn_rate.py` script only computes from the numbers given
This is third-party code. Review the repository files before installing.
What it does
The set turns the practices of Google's two free SRE books into step-by-step procedures, checklists and templates that the agent loads when a request matches. There is no retelling of the books: the procedures are written anew, and each skill links the chapters it draws on. Eight skills cover separate tasks. `sre-slos-and-error-budgets` helps pick SLIs and SLOs and write an error budget policy, `sre-monitoring-and-alerting` turns SLOs into multi-window multi-burn-rate alerts with Prometheus templates and the `burn_rate.py` calculator, `sre-incident-response` runs an incident by roles, `sre-postmortem` builds a blameless postmortem, `sre-release-and-launch` covers rollout and the launch checklist, `sre-on-call-and-toil` handles on-call and toil, `sre-capacity-and-system-design` computes capacity and resilience, and `sre-data-reliability` covers pipelines, backups and data integrity. An example from the README: given four weeks of checkout API metrics the skill proposes starter SLOs with allowed bad events and a filled-in document.
Who it is for. SRE engineers, DevOps staff and teams building on-call, SLOs and incident review who want to bring an agent into it.
Good fit when
- Starter SLOs must be proposed for a checkout API from measured availability and latency
- An SLO must be turned into Prometheus alerts over several budget-burn windows
- A production incident is under way and roles, a live document and status updates are needed
- After an outage a blameless postmortem with concrete action items must be written
Not a fit when
- A ready monitoring setup or integration with your stack is needed: the skills provide procedures and templates without connections
- The task is not about operations: application code and interface design are out of scope
- The exact text of Google's books is needed: the skills restate practices in their own words
Example request
Use sre-slos-and-error-budgets to propose starter SLOs for our checkout API: 3.2M requests over 4 weeks, 99.62% non-5xx, p99 1.1 sLimitations
The project is unofficial and not affiliated with Google. Google's books are licensed under CC BY-NC-ND 4.0, so the skills give original procedures and chapter links without book text. The skills only guide the agent: it does not see metrics, alerts or incidents in your system until you provide data. Some material lives in `references/` as templates, such as the error budget policy and postmortem templates, and must be adapted to the team. The `burn_rate.py` script needs Python. Practices are sized for Google-scale services, and small teams will simplify some procedures.
How to disable. Delete the `sre-*` folders from `~/.claude/skills/` or the project `.claude/skills/`.
FAQ
How do I install SRE Practice Skills in Claude Code?
Run `npx skills add paulip114/sre-practice-skills`. For one skill add `--skill sre-postmortem -a claude-code`, for all projects the `-g` flag. Manually, copy the `sre-*` folders into `~/.claude/skills/`.
Which skills are included?
Eight: SLOs and error budgets, monitoring and alerting, incident response, postmortem, release and launch, on-call and toil, capacity and system design, data reliability.
Where do the practices come from?
From the books Site Reliability Engineering (2016) and The Site Reliability Workbook (2018). It is an unofficial project, the procedures are in the authors' own words and each skill links the relevant chapters.
Can the skills build Prometheus alerts?
Yes, `sre-monitoring-and-alerting` has rule templates in `references/prometheus-rules.md` and the `scripts/burn_rate.py` calculator for multi-window multi-burn-rate budget alerts.
Do I need to call a skill manually?
No, Claude loads a skill when the request matches its description. You can also name one directly, for example "Use sre-postmortem to review this incident write-up".
Discussion
No questions or reviews yet.
Related
SkillsEight skills for Azure SRE Agent audit architecture, policy compliance, capacity and cost of a subscription and score it
A skill set for website performance and scalability, currently holding ooda-loop: observe, orient, decide, act.
A skill and Python library: four agent decision-quality indicators, a repeated-write guard and a circuit breaker for agent chains
Skill configures OpenTelemetry: collectors, sampling, security and telemetry from AI agents, without flooding the context.
Vercel's skill for Turborepo monorepos: turbo.json setup, caching, filters and CI, driven by the docs bundled in the installed package
The official Grafana skill set: PromQL, Loki, Tempo, Alloy, k6, dashboards and alerting for Claude Code, Cursor and Codex
README in short
The bilingual README explains why the set exists, how to install it through the `skills` CLI or by copying, how to call the skills, and shows an SLO example for a checkout API. It then lists the skills and licensing caveats.
README badge
Original SKILL.md
--- name: sre-slos-and-error-budgets description: Use when defining, reviewing or refining SLIs and SLOs, writing or applying an error budget policy (release freezes, reliability prioritization, escalation), or quantifying incidents and projects in error-budget terms. Based on Google SRE practice. --- # SLOs and Error Budgets Define what "reliable enough" means for users, then agree in advance what the organization does when the service falls short. ## SLO Design Design service level indicators (SLIs) and objectives (SLOs) that track what users experience, and that the organization will actually use to make decisions. ### Core ideas - An SLO is a target for "reliable enough". Above it, nearly all users are satisfied; below it, they start to complain or leave. - **100% is never the target.** Every extra nine costs more and is worth less to users, dependencies between you and the user add their own failures, and a 100% goal leaves no room for change, which is the main source of outages. - Express every SLI as **good events / valid events**, a ratio between 0% and 100%. Then error budget = 100% − SLO, and one set of tooling (numerator, denominator, threshold) works for every SLI. - Separate the **SLI specification** (what matters to the user, e.g. "home page loads in < 100 ms") from the **SLI implementation** (where and how it is measured). One spec can have several implementations that trade off fidelity, coverage and cost. - SLOs need an **owner empowered to trade velocity for reliability** — usually the product owner. ### Procedure 1. **Scope.** Pick one application. Name the users whose happiness you are optimizing. 2. **Map the system.** Sketch components, request flow, data flow and critical dependencies. Classify each component as *request-driven*, *pipeline* or *storage* (see `references/sli-menu.md`). 3. **List critical user journeys** (e.g. search → add to cart → checkout). These are what SLIs should ultimately represent. 4. **Choose SLI specs.** At most ~5 SLI types for the service. Use multiple thresholds for latency-like SLIs so you cover both the typical case and the tail (e.g. 90% < 100 ms *and* 99% < 400 ms). 5. **Choose implementations.** Start with the cheapest data that exists (logs or load-balancer metrics) over probers or client instrumentation that would take weeks. Prefer measuring as close to the user as is practical, and note what each source misses (e.g. server logs miss requests that never arrive). 6. **Set starter targets.** If nothing better is known, measure recent performance and round *down* to a manageable figure (e.g. two significant figures for availability, a coarse step for latency). Don't lock yourself into today's accidental excellence, but remember users come to expect whatever you deliver. 7. **Pick a window.** Default: a **4-week rolling window** (whole weeks keep weekend counts constant), with weekly summaries for prioritization and quarterly reports for planning. Use calendar windows only where business planning needs them. 8. **Compute the budget** in absolute terms (allowed bad events per window) so people can reason in "this outage cost 13% of our budget". 9. **Get agreement from three parties:** product (target is good enough for users), development (will act when budget runs out), operations (defensible without heroics or excessive toil). If any party won't sign, iterate on the SLI/SLO — don't ship an SLO without teeth. 10. **Document** it using `references/slo-document-template.md`, including the rationale and whether numbers are observational or ad hoc. Review monthly at first, quarterly once stable. 11. **Pair with** an error budget policy (*Error Budget Policy* below) and burn-rate alerts (`sre-monitoring-and-alerting`). ### Iterating on an existing SLO Collect a cheap signal of user happiness (support tickets, manually detected outages, forum posts, surveys). Then compare it with budget burn: - Real user pain that never dented the budget → poor **recall**: tighten the SLO or move/broaden the SLI implementation. - Budget burn with no user pain → poor **precision**: loosen the SLO or fix the SLI. - If moving the threshold either way gives too many false positives or negatives, the *implementation* is the problem, not the number. - Need a tighter target than you can meet today? Track it as an **aspirational SLO** that the error budget policy explicitly does not enforce. Use this matrix to decide what to do next: