break-glass

Grant temporary IAM permissions for on-call debugging on GCP projects.

2|1|Updated Oct 3, 2025
One-click install
npx skills add https://github.com/jamestexas/agents --skill break-glass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: break-glass
Source: https://github.com/jamestexas/agents/tree/main/skills/break-glass
Command: npx skills add https://github.com/jamestexas/agents --skill break-glass

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Emergency IAM elevation for on-call and debugging across GCP projects, enabling temporary access once needed and ensuring revocation after use.

Core Features & Use Cases

  • Discover and identify relevant GCP projects using hints or exact IDs.
  • Map short role shortcuts to full IAM roles and grant access with guided commands.
  • Provide clear revoke commands and cleanup reminders to minimize risk.

Quick Start

Invoke the break-glass workflow with a project hint or exact PROJECT_ID to temporarily grant access and revoke it when the task is complete.

Frequently Asked Questions about break-glass

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I grant temporary IAM permissions for on-call debugging on GCP projects?

This workflow grants temporary IAM permissions for on-call debugging by discovering GCP projects via hints or exact IDs, mapping short role names to full IAM roles, and outputting explicit grant commands for the gcloud CLI.

What is the best way to ensure emergency IAM elevation is revoked after use on GCP?

To ensure emergency IAM elevation is revoked, this workflow provides explicit revoke commands and cleanup reminders, ensuring temporary access granted for on-call debugging is safely removed from GCP projects.

Do I need the gcloud CLI to grant temporary GCP IAM access for on-call roles?

Yes, you need the gcloud CLI to grant temporary GCP IAM access, because this workflow generates safe, auditable grant and revoke commands designed to be executed directly through the gcloud CLI.

Can I discover a GCP project ID using partial hints when granting emergency IAM access?

Yes, you can discover a GCP project ID using partial hints, because the workflow identifies relevant GCP projects by hints or exact IDs before mapping short role names to full IAM roles for temporary grant and revoke workflows.

How does mapping short role names to IAM roles work for emergency GCP access?

Mapping short role names to IAM roles works by translating simple role shortcuts into fully qualified GCP IAM role identifiers, streamlining the generation of explicit grant and revoke commands for emergency on-call access.

What are the limitations of using break-glass for emergency IAM elevation on GCP?

A limitation of using break-glass for emergency IAM elevation is that it outputs commands for the gcloud CLI rather than directly mutating IAM policies, requiring manual execution and cleanup by the on-call user to ensure temporary access is revoked.