magi_guidelisted

# MAGI — Manual & Troubleshooting Skill (magi_guide) > **CLI (read first):** This skill drives the `magi` CLI (assumed installed on PATH). Full syntax for any command: `magi <command> --help`. If you are unsure where you are, run `magi sync`. MAGI ships its own operating manual inside the package — twelve scenario chapters, each written as *what to do → how → what you should see → what to do when you don't*. The same markdown backs the WebUI's Docs tab and the `magi guide` command, so what you read here is exactly what the user reads. **The rule this skill exists to enforce: never answer a MAGI usage question from memory.** Flags change between versions; the manual on disk describes *this* installation. Look it up, quote it, then act. > **Tools — capabilities, not names.** This skill asks for things like *read a > file*, *edit a file*, *run a shell command*, *search the web*, *fetch a page*, > *look at an image*, *spawn a sub-agent*. Every host calls these something > different and the names change between versions, so use whichever of yours > fits. If you genuinely lack one, say so and do the sequential equivalent — > never silently skip the step. > **Questions go to the main agent.** If you are running as a sub-agent, do not > try to ask the human: on most hosts the question will not reach them, and on > some it hangs. Put it in the report you return instead, on its own line: > `NEEDS-DECISION: <the question> | options: <a> / <b> | default if unanswered: <x>` > Whoever