bankr-error-handling

Diagnose Bankr API failures and apply retry, backoff, and escalation actions.

5|2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/buzzbysolcex/buzz-bd-agent --skill bankr-error-handling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bankr-error-handling
Source: https://github.com/buzzbysolcex/buzz-bd-agent/tree/main/skills/bankr-error-handling
Command: npx skills add https://github.com/buzzbysolcex/buzz-bd-agent --skill bankr-error-handling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents Bankr API failures from stalling jobs by diagnosing the exact cause and applying safe recovery steps for authentication, connectivity, rate limiting, and configuration issues.

Core Features & Use Cases

  • Self-Healing Diagnostics: Classifies Bankr API errors into actionable buckets (401/auth, timeouts/network, 429/rate limits, and missing/invalid BANKR_API_KEY).
  • Safe Recovery Actions: Validates environment configuration, performs reachability checks, waits for rate-limit reset when needed, and retries with exponential backoff for transient network failures.
  • Operational Escalation: Escalates to an operator (Ogie) with a diagnostic report when recovery attempts fail or auth may require key rotation.

Use case example: A scheduled Bankr-backed job starts failing with intermittent 429 and occasional timeouts; use this Skill to pause-and-retry on rate limits, back off on network issues, and alert only when human intervention is required.

Quick Start

Use bankr-error-handling to diagnose and recover from the current Bankr API error, including retries and operator escalation when appropriate.

Frequently Asked Questions about bankr-error-handling

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

FAQPage Schema
How do I handle Bankr API 429 rate limit errors in automated jobs?

Handling Bankr API 429 rate limit errors requires waiting for the rate-limit reset and retrying with exponential backoff. This approach diagnoses the 429 status, pauses automated job executions safely, and resumes requests only after the throttling window clears to prevent stalled workflows.

Why does my Bankr API integration return 401 authentication errors?

Bankr API 401 authentication errors occur when the BANKR_API_KEY is missing, malformed, or expired. Diagnosing this error requires verifying the key format and environment configuration, then escalating with a diagnostic report if the key needs rotation.

What's the best way to troubleshoot Bankr API connectivity and timeout issues?

Troubleshooting Bankr API connectivity and timeout issues involves verifying the reachability of api.bankr.bot and applying retry with exponential backoff for transient network failures. This self-healing approach recovers dropped connections without manual intervention.

Can I automatically recover Bankr API failures without manual intervention?

You can automatically recover Bankr API failures by diagnosing the exact cause and applying safe recovery actions. The system self-heals authentication, connectivity, and rate-limit issues autonomously, escalating to an operator with a diagnostic report only when backoff retries fail or key rotation is required.

When should I escalate Bankr API errors instead of retrying?

You should escalate Bankr API errors when recovery attempts fail after exponential backoff or when authentication issues require key rotation. Escalating with a diagnostic report ensures operator intervention only for persistent failures, preserving automated job stability for transient issues.