api-rate-limiters

Apply exponential backoff and circuit breaking to external API connections.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill api-rate-limiters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-rate-limiters
Source: https://github.com/ShubhamManachekar/GeoSupply/tree/main/.agent/skills/api-rate-limiters
Command: npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill api-rate-limiters

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Logical rules for handling real API connections, exponential backoff, circuit breaking, and block detection without mocks.

Core Features & Use Cases

  • Enforces the @breaker decorator on all external process() functions to ensure resilience.
  • Detects API blocks via HTTP status and rate-limit headers and raises structured WorkerError.
  • Provides SQLite-based TTL caching with defined windows to reduce duplicate calls and handle offline scenarios.

Quick Start

Configure a worker to apply exponential backoff and circuit breaking on API rate-limit events.

Frequently Asked Questions about api-rate-limiters

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

FAQPage Schema
How do I handle API rate limits with exponential backoff and circuit breaking?

Handle API rate limits by applying exponential backoff and a circuit breaker decorator to external API calls, which pauses requests and prevents cascading failures when blocks are detected.

How do I detect API blocks and rate limits via HTTP headers?

You detect API blocks by scanning HTTP status codes like 403 and rate-limit headers such as X-Rate-Limit-Remaining, then raising a structured WorkerError to stop execution.

Can I use SQLite caching to reduce duplicate API calls during rate limiting?

Yes, you can use SQLite-based TTL caching with configurable windows like 15 minutes or 6 hours to store dynamic data and reduce duplicate API calls during offline scenarios.

What is the best way to test API rate limiting without mocks?

The best way to test API rate limiting without mocks is to enforce the breaker decorator on real external connections and verify that structured WorkerErrors are raised upon block detection.

Why does my external API connection raise a WorkerError when blocked?

Your external API connection raises a WorkerError because the circuit breaker detects rate limit exhaustion via headers or 403 responses and proactively terminates the process to ensure resilience.