Inkbox Troubleshooting

Use when an Inkbox tool or channel reports runtime/config errors such as "Inkbox plugin is not configured", "whoami failed", "Vault is locked", "recipient_not_opted_in", or phone/mailbox readiness failures. Helps recover from misconfiguration and tool errors, not first-time setup walkthroughs.

44 stars 10 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add inkbox-ai/hermes-agent-plugin --skill inkbox-troubleshooting
Manual install
git clone --depth 1 https://github.com/inkbox-ai/hermes-agent-plugin.git /tmp/hermes-agent-plugin
mkdir -p ~/.claude/skills
cp -r /tmp/hermes-agent-plugin/skills/inkbox-troubleshooting ~/.claude/skills/inkbox-troubleshooting

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Inkbox troubleshooting

Use this skill when an Inkbox tool fails, the user asks why Inkbox is not working, or a channel readiness problem blocks email, SMS, calls, contacts, notes, or vault access.

## Common errors

| Error | Fix |
|---|---|
| `Inkbox plugin is not configured` | Set `apiKey` + `identity` in config, or run this plugin's Inkbox setup command (`<host> inkbox setup`). |
| `whoami failed: 401 Unauthorized` | API key is wrong, revoked, or has a typo. Ask the user to mint or paste a fresh key. |
| `whoami: API key is not agent-scoped` | Outbound may work, but access-scoped reads can behave differently. Prefer an agent-scoped key bound to the configured identity. |
| `404` on `getIdentity` | The configured `identity` handle does not exist under this key or does not match the key's bound identity. |
| `sender_sms_pending` | The Inkbox phone number is still propagating to carriers. Retry later and verify `smsStatus`. |
| `recipient_not_opted_in` | Ask the recipient to text `START` to the agent's Inkbox number, then retry. |
| `recipient_opted_out` | The recipient texted `STOP`; they must text `START` again before SMS can be sent. |
| `Vault is locked` | Set `INKBOX_HERMES_VAULT_KEY` through the local gateway secret mechanism and restart; never paste it in chat. |

## Vault unlock pattern
Read the full skill on GitHub

Details

Skill name
inkbox-troubleshooting
Path
skills/inkbox-troubleshooting/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Inkbox Troubleshooting skill do?

Use when an Inkbox tool or channel reports runtime/config errors such as "Inkbox plugin is not configured", "whoami failed", "Vault is locked", "recipient_not_opted_in", or phone/mailbox readiness failures. Helps recover from misconfiguration and tool errors, not first-time setup walkthroughs.

How do I install the Inkbox Troubleshooting skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add inkbox-ai/hermes-agent-plugin --skill inkbox-troubleshooting. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Inkbox Troubleshooting popular?

It lives in inkbox-ai/hermes-agent-plugin, which has 44 GitHub stars and 10 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.