error-handling

Detect and retry GitHub Actions token, permission, rate limit, and network failures.

3|3|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/adaptive-enforcement-lab/claude-skills --skill error-handling-adaptive-enforcement-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-handling
Source: https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/patterns/skills/error-handling
Command: npx skills add https://github.com/adaptive-enforcement-lab/claude-skills --skill error-handling-adaptive-enforcement-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines GitHub Actions workflows by detecting token, permission, rate limit, and network errors, then applying retries and clear error messaging to reduce manual debugging.

Core Features & Use Cases

  • Deterministic error classification by HTTP status codes (401, 403, 429) and network failures.
  • Exponential backoff retries with escalation paths and actionable guidance.
  • Quick-start references and a complete reference doc to integrate the pattern into CI jobs.

Quick Start

Execute the error-handling pattern in your workflow to automatically detect and recover from common GitHub App token and API errors.

Frequently Asked Questions about error-handling

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

FAQPage Schema
How do I handle GitHub Actions API errors like 401, 403, and 429 automatically?

Handle GitHub Actions API errors automatically by implementing deterministic error classification based on HTTP status codes, then applying exponential backoff retries for 401, 403, 429, and transient network failures to reduce manual debugging.

What is the best way to retry failed GitHub Actions workflows caused by rate limits?

The best way to retry workflows caused by rate limits is using exponential backoff strategies with clear escalation paths, which detects 429 rate limit errors and transient network issues before applying automated recovery attempts.

How do I recover from GitHub App token expiration errors in my CI pipeline?

Recover from GitHub App token expiration errors in your CI pipeline by detecting authentication failures and applying targeted retry strategies with actionable guidance to streamline token refresh and workflow continuation.

Does this error-handling approach work with existing GitHub Actions workflows?

Yes, this error-handling approach integrates into existing GitHub Actions workflows using provided quick-start references and comprehensive documentation that load into context during activation to support CI pipeline integration.

Why do my GitHub Actions jobs fail with transient network issues and how can I fix them?

GitHub Actions jobs fail with transient network issues due to temporary connectivity loss, which you can fix by applying automated detection and exponential backoff retries designed for network failures.

Are there limitations to automating GitHub Actions error handling for permission failures?

Automating error handling for permission failures targets 403 errors with classification and escalation messages, but cannot resolve underlying access restrictions without manual intervention to update repository or token permissions.