handoff-revoke

Reverses a deploy handoff by revoking OIDC credentials and emitting an idempotent revoke record.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Jin9/skillify-foundation --skill handoff-revoke-jin9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff-revoke
Source: https://github.com/Jin9/skillify-foundation/tree/main/treasury/handoff-revoke
Command: npx skills add https://github.com/Jin9/skillify-foundation --skill handoff-revoke-jin9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When a deploy handoff fails or must be undone, teams need a safe, auditable way to reverse it without deleting history or double-rolling back. This Skill performs the SAGA compensating action for the S6 handoff step: it revokes the issued short-lived OIDC credentials, signals the release control plane to halt or roll back the promotion, and appends an idempotent revoke record to the audit trail. ## Core Features & Use Cases - SAGA compensation: Reverses the handoff mechanics (credentials and control-plane promotion) tied to a specific receipt_id, not the business outcome. - Named-human approval gate: A named confirmer must approve the revoke; withheld confirmation blocks the action and routes to delivery-handoff-failures. - Idempotent, append-only audit: Replays for an already-revoked receipt return the existing record, and the original receipt is never deleted or rewritten. - Use Case: A delivery pipeline's S6 SAGA compensation fires after a failed release-handoff. Provide the receipt_id, reason, and idempotency_key; a named human confirms, and the skill revokes credentials, halts the promotion, and emits a revoke record with an audit_id. ## Quick Start Ask the agent to revoke the deploy handoff for a given receipt ID with a reason and idempotency key, then have a named human confirm the reversal.

Frequently Asked Questions about handoff-revoke

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

FAQPage Schema
How do I reverse a deploy handoff after a failed release?▼

Provide the original handoff receipt_id, a reason, and an idempotency key. A named human confirms the revoke, then the skill revokes the short-lived OIDC credentials, signals the control plane to halt or roll back the promotion, and emits a revoke record with an audit_id.

What is a SAGA compensating action in a deployment pipeline?▼

A SAGA compensating action is an explicit reversal step paired with a forward step that cannot be undone in place. Here it compensates the S6 handoff-to-deploy step by revoking credentials and rolling back the promotion tied to the receipt.

What happens if I revoke the same handoff receipt twice?▼

The skill is idempotent on receipt_id. A replay for an already-revoked receipt returns the existing revoke record and performs no second rollback, so duplicate compensation events are safe.

What happens when the compensation window has elapsed?▼

If the window has elapsed or the control plane refuses the reversal, the skill returns a partial status and escalates to a human forward-fix path rather than forcing an unsafe reversal of effects that must be corrected forward.

Does revoking a handoff delete the original audit history?▼

No. The revoke record is append-only and the original handoff receipt remains intact alongside it. Audit history is treated as evidence and is never deleted or rewritten.

When should I not use handoff revocation?▼

Do not use it to perform the forward handoff (use handoff-to-deploy), to validate production health, to respond to a live incident, or to delete audit history. It only reverses handoff mechanics within the compensation window.