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.
Install
npx skills add inkbox-ai/hermes-agent-plugin --skill inkbox-troubleshootinggit 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-troubleshootingPersonal 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
Details
- Skill name
inkbox-troubleshooting- Repository
- inkbox-ai/hermes-agent-plugin
- 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
Inkbox Call Review
44inkbox-ai/hermes-agent-plugin
Use when the user asks about Inkbox call history, transcripts, missed calls, active-call status, or post-call follow-up work.
Inkbox Contact Lookup
44inkbox-ai/hermes-agent-plugin
Use when the user asks "who is X", "what's the email for Y", "find a contact named Z", "save this contact", or any question that needs contact context. Contacts are shared across the Inkbox organization.
Inkbox Contact Rules
44inkbox-ai/hermes-agent-plugin
Use when the user wants to block, allow, delete, or list Inkbox contact-rule filters for the agent's mailbox or phone number. Hermes does not expose contact-rule edit tools; guide the user to Inkbox Console or explain the limitation.
Overview
49lis186/SourceAtlas
Get project overview - scan <5% of files to achieve 70-80% understanding
Inkbox Sms Responder
44inkbox-ai/hermes-agent-plugin
Use when the user asks to send a text, reply to an SMS, or process the SMS queue — also use automatically when an inbound `text.received` event arrives from Inkbox. Handles per-conversation context, opt-in/opt-out gates, and the 10DLC carrier propagation window.
Ijfw Compute
43FerroxLabs/wayland-core
Compute over read. Run sandboxed scripts to process data instead of dumping it into context. Trigger: 'compute', 'process this data', 'analyze logs', or PreToolUse nudge.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.