Borrowing it
Nothing to install: this file belongs to kensaurus/mushi-mushi. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/kensaurus/mushi-mushi/master/.cursor/skills/mushi-debug/SKILL.mdgit clone --depth 1 https://github.com/kensaurus/mushi-mushiWrote 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/kensaurus/mushi-mushi/mushi-debug)<a href="https://agentmods.dev/skills/kensaurus/mushi-mushi/mushi-debug"><img src="https://agentmods.dev/badge/skills/kensaurus/mushi-mushi/mushi-debug.svg" alt="Measured on agentmods" 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.00092 | $0.01273 |
| Opus 5 | $0.00046 | $0.00636 |
| Sonnet 5 | $0.00018 | $0.00255 |
| Haiku 4.5 | $0.00009 | $0.00127 |
Grade A, and why
mushi-debug 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 6d 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 — 143 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Mushi Debug Guide
SDK Not Reporting Events
Symptoms: Inventory → Discovery shows 0 events.
- Check the SDK is initialized before any navigation:
Mushi.init({ projectId: '...', apiKey: '...', capture: { discoverInventory: { enabled: true } } }) - Verify the API key starts with
mushi_and belongs to the correct project. - Check browser console for
[Mushi]errors. - Run
mushi doctor— confirms reachability.
API Key Exhausted / Rate Limited
Symptoms: "ALL_KEYS_EXHAUSTED" error, quota banner in Settings.
# Check key health
mushi keys list
# Add a backup key
mushi keys add --provider anthropic --key sk-ant-... --label "Backup"
In the console: Settings → API Key Pool → keys in quota_exhausted state show cooldown timer (resets in 1 hour automatically).
Story Mapping Failed
Symptoms: mushi stories map returns error or crawl run shows failed.
- Confirm Firecrawl key is configured:
mushi keys list # Should show firecrawl [active] - Verify the URL is publicly reachable (not localhost).
- Check the console: Inventory → Discovery → Recent crawls for the error message.
- Try with fewer pages:
mushi stories map --url <url> --max-pages 5 --wait
QA Story Failing Hourly
Symptoms: Slack message every hour — :warning: QA story <name> errored — or Firecrawl 401.
Most common root causes and fixes:
| Error | Cause | Fix |
|---|---|---|
Firecrawl 401 Unauthorized: Token missing |
No Firecrawl BYOK key in project | mushi integrations test firecrawl → if fails, add key: mushi keys add --provider firecrawl --key fc-... |
no_target_url: set a Target URL on this story |
Story has no target_url and prompt doesn't contain a URL |
Edit story in QA Coverage → Edit → Target URL |
| Link in Slack opens wrong page | Old story created before Jun 2026 deep-link fix | Links now go to /qa-coverage?story=<id>&run=<run-id> — verify admin console URL is correct |
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.
- 6d ago First seen · 143 lines · 92 tokens per session scan A 1d35cec949d4
mushi-debug is a skill published in the GitHub repository kensaurus/mushi-mushi (3 stars, last pushed 9d ago), licensed MIT. It adds 92 tokens to every session and 1,273 once invoked, about $0.0005 per session on Opus 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-31.
Other skills, from other repositories
langsmith-observability
LLM observability platform for tracing, evaluation, and monitoring. Use when debugging LLM applications, evaluating model outputs against datasets, monitoring production systems, or building systematic testing pipelines for AI applications.
phoenix-observability
Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.
langsmith-observability
LLM observability platform for tracing, evaluation, and monitoring. Use when debugging LLM applications, evaluating model outputs against datasets, monitoring production systems, or building systematic testing pipelines for AI applications.
tracely
Instrument AI agents with Tracely and turn their production traces into CI gates. Use when the user mentions Tracely, tracely-ai, tracelysdk, the tracely CLI, or asks to trace/observe an AI agent, add LLM evaluators or LLM-as-a-judge columns, debug why a trace or conversation isn't showing up, wire agent regression…
bug-hunter
Precision-first adversarial bug hunting for runtime, logic, data, concurrency, and security defects. Uses deterministic risk triage, evidence-bounded retrieval, Hunter/Skeptic/Referee review, optional hybrid verification, and explicit immutable Fixer scope. Scan-only and single-pass by default; complete-coverage…
hunter
Deep behavioral code analysis agent for Bug Hunter. Performs multi-phase scanning to find logic errors, security vulnerabilities, race conditions, and runtime bugs. Uses doc-lookup (Context Hub + Context7) for framework verification. Reports structured JSON findings.