How do I install the Bankr Agent Error Handling skill?

Run npx skillmds@latest add tomevault-io/bankr-agent-error-handling in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bankr Agent Error Handling safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bankr Agent Error Handling?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bankr Agent Error Handling free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bankr Agent Error Handling?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bankr Agent Error Handling by tomevault-io

Name: Bankr Agent Error Handling
Author: tomevault-io

Bankr Agent Error Handling

This skill should be used when encountering authentication errors, API key errors, 401 errors, "invalid API key", "BANKR_API_KEY not set", job failures, or any Bankr API errors. Provides setup instructions and troubleshooting guidance for resolving Bankr configuration issues. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Bankr Error Handling

Resolve Bankr API errors and authentication issues.

Authentication Errors (401)

Symptoms

HTTP 401 status code
"Invalid API key" or "Unauthorized" message

Resolution

Present these setup instructions to the user:

Step 1: Create an API Key

Visit https://bankr.bot/api to create a new API key

Step 2: Set Environment Variable

# Add to shell profile (~/.zshrc or ~/.bashrc)
export BANKR_API_KEY=bk_your_api_key_here

Step 3: Restart Claude Code

Close and reopen the terminal/Claude Code session

Important: Do NOT retry when authentication fails. User must fix API key first.

Common Job Failures

Error	Cause	Resolution
Insufficient balance	Not enough tokens	Check balance, reduce amount
Token not found	Invalid symbol/address	Verify token exists on chain
Slippage exceeded	Price moved too much	Retry or try smaller amount
Transaction reverted	On-chain failure	Check transaction details
Rate limit exceeded	Too many requests	Wait and retry

HTTP Status Codes

Code	Meaning	Action
400	Bad request	Check prompt format
401	Unauthorized	Fix API key (see above)
402	Payment required	Ensure wallet has BNKR on Base
429	Rate limited	Wait and retry
500	Server error	Retry after delay

Troubleshooting Checklist

API Key: Set, starts with bk_, Claude Code restarted after setting
Network: Internet working, api.bankr.bot reachable
For Trading: Wallet has sufficient balance, token exists on chain

Reporting Errors to Users

State what went wrong simply
Provide specific fix steps
Avoid technical jargon
Suggest alternatives

Example:

Your Bankr API key is not configured. To set it up:
1. Visit https://bankr.bot/api to create an API key
2. Set BANKR_API_KEY in your environment
3. Restart Claude Code

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: bankr-agent-error-handlingdescription: This skill should be used when encountering authentication errors, API key errors, 401 errors, "invalid API key", "BANKR_API_KEY not set", job failures, or any Bankr API errors. Provides setup instructions and troubleshooting guidance for resolving Bankr configuration issues. Use when this capability is needed.---# Bankr Error HandlingResolve Bankr API errors and authentication issues.## Authentication Errors (401)### Symptoms- HTTP 401 status code- "Invalid API key" or "Unauthorized" message### ResolutionPresent these setup instructions to the user:**Step 1: Create an API Key**```Visit https://bankr.bot/api to create a new API key```**Step 2: Set Environment Variable**```bash# Add to shell profile (~/.zshrc or ~/.bashrc)export BANKR_API_KEY=bk_your_api_key_here```**Step 3: Restart Claude Code**```Close and reopen the terminal/Claude Code session```**Important**: Do NOT retry when authentication fails. User must fix API key first.## Common Job Failures| Error | Cause | Resolution ||-------|-------|------------|| Insufficient balance | Not enough tokens | Check balance, reduce amount || Token not found | Invalid symbol/address | Verify token exists on chain || Slippage exceeded | Price moved too much | Retry or try smaller amount || Transaction reverted | On-chain failure | Check transaction details || Rate limit exceeded | Too many requests | Wait and retry |## HTTP Status Codes| Code | Meaning | Action ||------|---------|--------|| 400 | Bad request | Check prompt format || 401 | Unauthorized | Fix API key (see above) || 402 | Payment required | Ensure wallet has BNKR on Base || 429 | Rate limited | Wait and retry || 500 | Server error | Retry after delay |## Troubleshooting Checklist1. **API Key**: Set, starts with `bk_`, Claude Code restarted after setting2. **Network**: Internet working, api.bankr.bot reachable3. **For Trading**: Wallet has sufficient balance, token exists on chain## Reporting Errors to Users1. State what went wrong simply2. Provide specific fix steps3. Avoid technical jargon4. Suggest alternatives**Example**:```Your Bankr API key is not configured. To set it up:1. Visit https://bankr.bot/api to create an API key2. Set BANKR_API_KEY in your environment3. Restart Claude Code```---> Converted and distributed by [TomeVault](https://tomevault.io/claim/bankrbot) — claim your Tome and manage your conversions.

Frequently asked questions