Skylv Api Error Handler

Handles API errors with smart retry strategies and fallbacks

Security Scan

The skill's files, instructions, and behavior are coherent with an API error-handling utility; it is local, has no external credentials, and does not perform surprising network or privileged actions.

Purpose & Capability

The name/description match the included JS implementation: categorizing errors, recommending fixes, exposing retry strategies, logging and stats. No unrelated dependencies or credentials are requested.

Instruction Scope

SKILL.md instructs running the bundled Node script and the script itself only reads/writes a local log file (.api-errors.json) and analyzes provided text/status. It does not contact external endpoints or read other system configs. Note: the script logs raw error text and optional context to disk, which could contain sensitive information.

Install Mechanism

No install spec is provided (instruction-only + included JS file). No downloads, package installs, or archive extraction are performed by the skill itself.

Credentials

The skill requests no environment variables or credentials and the code does not read process.env. Example strings reference APIs/configs but are not executed or required.

Persistence & Privilege

The skill persists up to 100 recent error entries in a local dotfile (.api-errors.json) in the working directory. It does not request elevated privileges, modify other skills, or force installation (always:false).

Assessment

This skill appears coherent for offline/local API error handling. Before installing: review the api_error_handler.js yourself to confirm you’re comfortable with it writing a .api-errors.json file in whatever directory you run it from (error messages or context may contain sensitive data such as API keys, endpoints, or PII). Run it in a safe project directory, inspect or rotate any credentials that might accidentally be logged, and consider adding log redaction or restricting file permissions if you plan to persist logs long-term.

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