Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add emanueleielo/ciana-parrot --skill troubleshootinggit clone --depth 1 https://github.com/emanueleielo/ciana-parrotWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/emanueleielo/ciana-parrot/troubleshooting)<a href="https://agentmods.dev/skills/emanueleielo/ciana-parrot/troubleshooting"><img src="https://agentmods.dev/badge/skills/emanueleielo/ciana-parrot/troubleshooting/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/emanueleielo/ciana-parrot/troubleshooting"><img src="https://agentmods.dev/badge/skills/emanueleielo/ciana-parrot/troubleshooting.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00031 | $0.01443 |
| Opus 5.5 | $0.00012 | $0.00577 |
| Sonnet 5.5 | $0.00006 | $0.00289 |
| Haiku 4.5 | $0.00003 | $0.00144 |
Grade A, and why
troubleshooting scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 160 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Troubleshooting
Reference guide for diagnosing errors. Read this when a command fails, a bridge is unreachable, or a user reports something isn't working.
When to Use
- A
host_executecall returns an error - Claude Code mode fails
- User says something "doesn't work" or asks how to set up a feature
- You get connection, auth, or permission errors
Gateway Errors
"Cannot connect to host gateway. Is the gateway server running?"
The gateway process is not running on the host machine.
Tell the user: Run make gateway on the host (outside Docker) to start it.
"Gateway auth failed. Check GATEWAY_TOKEN."
The token in the Docker container doesn't match the one on the host.
Tell the user: Verify that GATEWAY_TOKEN in .env matches on both sides, then restart both gateway and container.
"unknown bridge 'X'. Available: ..."
The bridge name doesn't exist in config.yaml under gateway.bridges.
Check: Are you using the correct bridge name? Compare with the available list in the error.
"command 'X' not allowed for bridge 'Y'"
The CLI command is not in the bridge's allowed_commands list. This is a security feature.
Tell the user: Add the command to the bridge's allowed_commands in config.yaml and restart the gateway.
CLI Not Found
"Command 'X' not found on host. Install it first."
The CLI binary is not installed on the host. Exit code 127.
Installation commands (Homebrew):
| CLI | Install command |
|---|---|
remindctl |
brew install steipete/tap/remindctl |
imsg |
brew install steipete/tap/imsg |
spogo |
brew install steipete/tap/spogo |
wacli |
brew install steipete/tap/wacli |
sonoscli |
brew install steipete/tap/sonoscli |
bear |
brew install steipete/tap/bear |
camsnap |
brew install steipete/tap/camsnap |
peekaboo |
brew install steipete/tap/peekaboo |
blucli |
brew install steipete/tap/blucli |
obsidian-cli |
brew install steipete/tap/obsidian-cli |
openhue |
brew install openhue/cli/openhue |
things-cli |
brew install thingsapi/things-cli/things-cli |
op |
brew install 1password-cli |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 160 lines · 31 tokens per session scan A 57bc353b6f5e
troubleshooting is a skill published in the GitHub repository emanueleielo/ciana-parrot (77 stars, last pushed 22d ago), licensed MIT. It adds 31 tokens to every session and 1,443 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
ha-logs
A read-only troubleshooting skill for querying Hope Agent’s local SQLite databases, which store logs, conversations, and background-job status.
ha-self-diagnosis
Self-understanding and issue reporting for Hope Agent itself. Use when the user asks how Hope Agent works internally, asks about its own source code/docs/runtime behavior, reports a bug/failure/slowness/crash, asks to diagnose logs, or asks to create/submit a GitHub issue for a bug, feature request, or improvement…
ha-debug
Hope-native debugging for code failures, regressions, crashes, flaky behavior, and bad output: reproduce or characterize, rank falsifiable hypotheses, fix the smallest root cause, and prove the failing path.
skill-generator
Generates AND modifies complete skills from natural language descriptions. Guides the user through need analysis and archetype selection, produces a skill package compliant with the agentskills.io standard, and proposes it to the user, who installs it in one click. Also adjusts, enriches or fixes an existing user…
briefing-quotidien
Trigger ONLY when the user explicitly asks for a "briefing" or a complete overview of their WHOLE day. Generates the full daily briefing: agenda, tasks, weather, emails and reminders — always ALL sections together. A request about one specific category or item (appointments, meetings, events, emails, tasks, weather …
coaching-productivite
Provides productivity coaching with prioritization frameworks (Eisenhower, Pomodoro) and habit-building strategies. Use when the user asks for help organizing tasks, managing time, or improving productivity.