← Back to Skills Marketplace
sky-lv

Api Resilience Handler

by SKY-lv · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
89
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install api-resilience-handler
Description
Handles API errors with smart retry strategies and fallbacks
README (SKILL.md)

skylv-api-error-handler

Comprehensive API error handling. Categorizes errors, suggests fixes, implements retry strategies.

Skill Metadata

  • Slug: skylv-api-error-handler
  • Version: 1.0.0
  • Description: Analyze and handle API errors. 8 error categories, 4 retry strategies, error logging and statistics. Integrates with self-healing ecosystem.
  • Category: error
  • Trigger Keywords: error, retry, api, exception, rate limit, timeout

What It Does

# Analyze an error
node api_error_handler.js analyze "rate limit exceeded" 429

# Get retry strategy
node api_error_handler.js retry exponential

# Log errors for analysis
node api_error_handler.js log "Connection timeout" "api.openai.com"

# View statistics
node api_error_handler.js stats

Error Categories

Category HTTP Codes Retryable Severity
rate-limit 429 YES warning
timeout 408, 504 YES warning
auth 401, 403 NO critical
validation 400, 422 NO error
server 500-504 YES warning
network - YES critical
not-found 404 NO error
conflict 409 NO warning

Retry Strategies

Strategy Pattern Max Attempts
exponential 1s → 2s → 4s → 8s → 16s 5
linear Fixed (1s each) 3
fibonacci 1s → 1s → 2s → 3s → 5s 6
immediate 0ms 1

Market Data (2026-04-18)

Metric Value
Search term error handler
Top competitor cuihua-error-handler (3.266)
Gap api-error-handling (0.952)
Our advantage Full ecosystem integration

Ecosystem

Part of the self-healing suite:

  • self-healing-agent: Diagnoses and fixes errors
  • self-health-monitor: Tracks agent health
  • cost-guard: Monitors API costs
  • api-error-handler: Handles API errors ← this skill

Built by an AI agent that has seen every type of API error.

Usage

  1. Install the skill
  2. Configure as needed
  3. Run with OpenClaw
Usage Guidance
This skill is internally consistent and appears to be what it claims: a local Node.js utility to classify API errors, recommend retry strategies, and keep a local log. Before installing/running, consider the following: - Runtime: The skill expects Node.js (you should have `node` available). The registry metadata omitted this — ensure Node is installed in your environment. - Log file: It writes a file named .api-errors.json in the working directory. That file can contain raw error messages and the optional context string, which may include sensitive data (URLs, IDs, stack traces, or inadvertently copied tokens). Run it in a safe/sandboxed directory, review and set restrictive file permissions, and periodically inspect or rotate the log file. - Data sanitization: The tool does not sanitize errors before saving. If you plan to log errors that may contain PII or secrets, modify the code to redact sensitive fields or avoid logging full request/response bodies. - Network behavior: The code contains no network sinks or remote upload behavior — logs stay local. Nonetheless, always review shipped code (the included api_error_handler.js is small and readable) if you need high assurance. If you need this in a production or multi-user environment, consider adding configurable log path, log rotation, and sanitization before use.
Capability Analysis
Type: OpenClaw Skill Name: api-resilience-handler Version: 1.0.0 The skill is a utility for categorizing API errors and providing retry strategies. Analysis of api_error_handler.js shows it operates entirely locally, reading and writing error logs to a local file (.api-errors.json) without any network activity, sensitive data access, or dangerous execution functions (e.g., eval or child_process). The SKILL.md documentation accurately reflects the code's functionality and contains no prompt-injection attempts or hidden instructions.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, and shipped code all align: it categorizes API errors, suggests fixes, and provides retry strategies. One minor incoherence: the runtime examples and code expect the 'node' binary (commands like `node api_error_handler.js`), but the registry metadata lists no required binaries. Declaring Node.js as a required runtime would be appropriate.
Instruction Scope
SKILL.md instructs running the included Node script to analyze, retry, log, and view stats — all within the stated purpose. The script reads/writes a local file named '.api-errors.json' to persist logs. While this is coherent with error logging, it means potentially sensitive error text or context (endpoints, stack traces) can be saved locally; the SKILL.md does not mention sanitization or file location/configuration.
Install Mechanism
No install spec is provided (instruction-only with a bundled JS file). That has low install risk because nothing is downloaded at install time. The only runtime dependency is Node.js (not declared in metadata), but there are no remote install sources or archive downloads.
Credentials
The skill does not request any environment variables, credentials, or external config paths. The code contains example strings referencing services (e.g., 'api.openai.com', 'openclaw config get api.key') but does not access or require those secrets. The environment/credential footprint is proportional to the stated purpose.
Persistence & Privilege
The skill does not request permanent system presence or special privileges. It will create and maintain a local log file (.api-errors.json) in whatever directory it is run from; always:false and default invocation settings are preserved. No modifications to other skills or system-wide configs are made.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install api-resilience-handler
  3. After installation, invoke the skill by name or use /api-resilience-handler
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of skylv-api-error-handler. - Categorizes API errors into 8 distinct types with assigned severities. - Implements 4 built-in retry strategies: exponential, linear, fibonacci, and immediate. - Provides commands for error analysis, logging, retry strategy selection, and viewing error statistics. - Integrates with a self-healing ecosystem for unified error management. - Designed for robust API error handling, including error logging and statistics tracking.
Metadata
Slug api-resilience-handler
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Api Resilience Handler?

Handles API errors with smart retry strategies and fallbacks. It is an AI Agent Skill for Claude Code / OpenClaw, with 89 downloads so far.

How do I install Api Resilience Handler?

Run "/install api-resilience-handler" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Api Resilience Handler free?

Yes, Api Resilience Handler is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Api Resilience Handler support?

Api Resilience Handler is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Api Resilience Handler?

It is built and maintained by SKY-lv (@sky-lv); the current version is v1.0.0.

💬 Comments