Skip to content
Back to search

sre

MarketplaceWorks with Claude CodeGitHub

SRE Extension to provide Site Reliability Engineering tools for CLI harness investigations (agy, Gemini CLI, claude, ..) on Google Cloud et al.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gemini-cli-extensions--sre/badge.svg)](/listings/gemini-cli-extensions--sre)

HTML

<a href="/listings/gemini-cli-extensions--sre"><img src="/api/listings/gemini-cli-extensions--sre/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

For detailed installation and configuration instructions across all CLI environments, please refer to the [Installation Guide (INSTALL.md)](INSTALL.md).

If you have [`just`](https://github.com/casey/just) (a modern `make` clone) installed, you can quickly set up the extension. If you don't have `just` yet, you can quickly install it via `brew install just` / `sudo apt-get install just` (or see [casey/just](https://github.com/casey/just#installation) for more options).

Once installed:

# Google Antigravity CLI (agy)
just install-agy
# Google Gemini CLI (deprecated)
just install-gemini
# Claude Code
just install-claude
# GitHub Copilot CLI
just install-copilot-persistent

You also need `python` and `uv` installed.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json Β· Manifest Β· 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "sre",
  3. "owner": {
  4. "name": "Google"
  5. },
  6. "metadata": {
  7. "description": "Marketplace for the SRE extension: curated agent skills for Site Reliability Engineers on Google Cloud."
  8. },
  9. "plugins": [
  10. {
  11. "name": "sre-extension",
  12. "source": "./",
  13. "description": "πŸ‰ Specialised SRE skills for outage investigations, monitoring graphs, and post-mortems on Google Cloud Platform."
  14. }
  15. ]
  16. }
README.md Β· README Β· 131 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/sre-extension-logo.png" width="400" alt="SRE Extension Logo">
  3. </p>
  4. > **Note:** Given the recent [deprecation of Gemini CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/), this Extension is also fully functional as a Plugin for [agy CLI](https://antigravity.google), Claude Code, and Codex.
  5. # About
  6. **The SRE Gemini CLI Extension** is a dedicated toolkit comprising specialized **Skills** designed to augment Site Reliability Engineers (SREs). By integrating deeply with the Gemini CLI, this extension empowers SREs to investigate outages, configure MCP servers, formulate mitigations, and detect anomalies more rapidly.
  7. See also:
  8. * [Reference PostMortems](https://github.com/palladius/about-sre-extension/) we've created with this tool.
  9. * [SRE Testing Suite](https://github.com/palladius/sre-testing-suite) to test your setups (currently a work in progress) and its related **[Codelab](https://codelabs.developers.google.com/codelabs/investigate-gke-cluster-breakage-scenarios-with-postmortem#0)**.
  10. ## πŸ“Ί Demo Outage Investigation
  11. Watch the **SRE Extension** in action as it performs a live production outage investigation and generates a detailed PostMortem:
  12. [![SRE Extension Demo Outage Investigation](docs/sre-demo-video-thumbnail.png)](https://youtu.be/bPCznsjW8BU)
  13. ## Installation
  14. For detailed installation and configuration instructions across all CLI environments, please refer to the [Installation Guide (INSTALL.md)](INSTALL.md).
  15. If you have [`just`](https://github.com/casey/just) (a modern `make` clone) installed, you can quickly set up the extension. If you don't have `just` yet, you can quickly install it via `brew install just` /
  16. `sudo apt-get install just` (or see [casey/just](https://github.com/casey/just#installation) for more options).
  17. Once installed:
  18. ```bash
  19. # Google Antigravity CLI (agy)
  20. just install-agy
  21. # Google Gemini CLI (deprecated)
  22. just install-gemini
  23. # Claude Code
  24. just install-claude
  25. # GitHub Copilot CLI
  26. just install-copilot-persistent
  27. ```
  28. You also need `python` and `uv` installed.
  29. ## Available Skills
  30. ### πŸ› οΈ Core SRE Skills
  31. - **`investigation-entrypoint`**: Primary entrypoint for investigating production outages, orchestrating SRE response, and mitigating incidents. Start here when an incident occurs!
  32. - **`gcp-architecture-discovery`**: Discover and map GCP infrastructure architecture including compute, networking, storage, and service dependencies.
  33. - **`gcp-playbooks`**: Follows established SRE playbooks for GCP/GKE investigations, including infrastructure discovery and common mitigation steps.
  34. - **`gcp-mcp-setup`**: Automates enabling services, Google Managed MCP (OneMCP) servers, generating API keys, and configuring the MCP settings file for your CLI harness (Gemini, Antigravity, or Copilot).
  35. - **`gcp-slo-management`**: Discover Monitoring Services, list existing SLOs, or create new SLOs (Availability/Latency) via the REST API.
  36. - **`postmortem-generator`**: Creates a generated PostMortem given enough context about a resolved incident/outage.
  37. ### ☁️ Cloud Capabilities
  38. - **`cloud-build-investigation`**: Expert-level SRE skill for Google Cloud Build (GCB) and Cloud Run investigations. Correlates git commits with build failures and analyzes logs.
  39. - **`cloud-logging`**: Skill for interacting with and analyzing Google Cloud Logging and Error Reporting. Processes large JSON logs or converts them to Apache format.
  40. - **`cloud-monitoring`**: Interacts with Google Cloud Monitoring via APIs to avoid large context bloat. Exports time-series data and helps setup SLOs.
  41. ### πŸ“Š Detection, Graphs & Mitigations
  42. - **`generic-mitigations`**: Generic Mitigations high-level classification logic and actuation plan.
  43. - **`monitoring-graphs`**: Generates high-quality, annotated incident graphs for post-mortems using Python to visualize outages and error rates (nice graphs visible [here](https://github.com/palladius/about-sre-extension/)).
  44. - **`anomaly-detection`**: Detects anomalies in time-series data from various sources (Isolation Forest, KNN, Z-score).
  45. - **`data-ingestion`**: Fetches and parses time-series data from various sources for downstream analysis.
  46. ## Compatibility & Harness Support
  47. | Capability | Gemini CLI | Antigravity (`agy`) | Claude Code | Codex | Copilot CLI |
  48. | :----------------------| :----------:| :--------------------------------------------------------:| :--------------------------------------------------------:| :--------------------------------------------------------:| :--------------------------------------------------------:|
  49. | **Type** | Extension | [Plugin](https://antigravity.google/docs/plugins) | [Plugin](https://code.claude.com/docs/en/plugins-reference) | [Plugin](https://developers.openai.com/codex/plugins) | [Plugin](https://docs.github.com/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating) |
  50. | **Install** | βœ… | βœ… | βœ… | 🟒 | βœ… |
  51. | **MCP Setup** | βœ… | βœ… | 🟒 | 🟒 | βœ… |
  52. | **SRE Skills** | βœ… | βœ… | 🟒 | 🟒 | βœ… |
  53. | **GKE Investigation** | βœ… | βœ… | 🟒 | 🟒 | 🟒 |
  54. **Legend:** βœ… Works (Tested) | 🟒 Works (Untested) | πŸ”΄ Doesn't Work (Red Flag)
  55. ## Quickstart
  56. 1. Install this extension by following the instructions in [INSTALL.md](INSTALL.md).
  57. 2. Only for the first time, use `gcp-setup` and `gcp-mcp-setup` skills to ensure your GCP project and MCP servers are set up correctly:
  58. ```bash
  59. $ agy
  60. /gcp-setup Setup my GCP project "foo-bar-123"
  61. with email `jane-doe-sre@credible-company.com`.
  62. [..]
  63. /gcp-mcp-setup Also set up MCP access to Cloud Logging,
  64. Cloud Monitoring, GKE and Documentation (Developer Knowledge). Skip
  65. BQ and Cloud Run for this time.
  66. ```
  67. 3. Invoke the entrypoint skill with your incident request. For example:
  68. ```bash
  69. $ agy
  70. /investigation-entrypoint Use investigation entrypoint skill
  71. with this new incident: GKE cluster with frontend 1.2.3.4 is reported
  72. down by numerous customers, please investigate.
  73. ```
  74. 4. The agent will take it from thereβ€”fetching context, querying metrics, and formulating mitigations.
  75. For detailed instructions on setup and usage, please refer to the [User Manual](USER_MANUAL.md).
  76. ## Contributing
  77. Check `CONTRIBUTING.md`.
  78. ## πŸ—ΊοΈ Public Resources Map
  79. Here is a visual map showing how the SRE Extension codebase, testing suite, postmortems, and learning tutorials relate to each other:
  80. ![Public SRE Resources Map](docs/public-resources-map.png)
  81. For a detailed description of the mappings, see [docs/public-resources-map.md](docs/public-resources-map.md).
  82. ## Feedback
  83. For feedback, please report **bugs** and **feature requests** in the issue tracker.
  84. Any other intelligible feedback should be sent to this form: [SRE Extension Survey](https://forms.gle/eJPrbG4KKESp6GmF6)
  85. # Thanks
  86. Program Lead: [Riccardo](https://github.com/palladius)
  87. Co-authors and contributors:
  88. - [Madhavi](https://github.com/madkarra)
  89. - [RamΓ³n](https://github.com/rmedranollamas)
  90. - [Szymon](https://github.com/szymonst)
  91. <!-- add your name here -->

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.