muggle-repair git:20261021.3f2b3f6A

Immutable. This exact content never changes and is served at /api/v1/blob/888b388ad3d365a9.

---
name: muggle-repair
model: haiku
description: Diagnose and fix a broken Muggle AI installation. Use when user types muggle repair or asks to fix Muggle Test setup.
---

# Muggle Test Repair

> Telemetry first step: see [`_shared/telemetry-emit.md`](../_shared/telemetry-emit.md). Use `skillName: "muggle-repair"`.

> Running outside Claude Code (in Codex, for one)? Read [`../_shared/host-tool-equivalents.md`](../_shared/host-tool-equivalents.md) first — it maps the tools and paths this skill names to your host's.

Automatically diagnose and fix broken components.

## Steps

1. Run the same checks as `/muggle:muggle-status` to identify what is broken.
2. If everything passes, report: "Nothing to repair — installation looks healthy."
3. For each failing component:
   - **Electron app missing or corrupt** — run `muggle setup --force` to re-download.
   - **Authentication expired or invalid** — run `muggle-remote-auth-login` to re-authenticate.
   - **MCP server unresponsive** — report the error and suggest restarting the session.
4. Run status checks again to confirm all components are healthy.
5. Report what was repaired.

## Output

Show before/after status for each repaired component. If repair fails, report the error with enough context for the user to investigate.