| 1 | --- |
| 2 | name: reasonix-guide |
| 3 | description: "Diagnose missing or misconfigured Reasonix skills, commands, hooks, MCP servers, plugins, and instructions." |
| 4 | runAs: inline |
| 5 | --- |
| 6 | |
| 7 | # Reasonix capability diagnostics |
| 8 | |
| 9 | For a loading or configuration problem, start with the relevant section of |
| 10 | `reasonix doctor capabilities --json`. This static report starts no MCP |
| 11 | subprocesses and makes no network calls. Use its issue codes, sources, and |
| 12 | remediations; a configuration question with enough evidence needs no full report. |
| 13 | |
| 14 | ## References |
| 15 | |
| 16 | Read only the page needed for the reported capability. These files are bundled |
| 17 | in the binary; a `(builtin:...)` source is not a local filesystem path. |
| 18 | |
| 19 | | Capability | Reference | |
| 20 | | --- | --- | |
| 21 | | Skill discovery, priority, overrides | [skills](references/skills.md) | |
| 22 | | Slash command naming and overrides | [commands](references/commands.md) | |
| 23 | | Hook events, matching, timeouts | [hooks](references/hooks.md) | |
| 24 | | MCP sources, transport, startup | [MCP](references/mcp.md) | |
| 25 | | Plugin manifests and loading | [plugins](references/plugins.md) | |
| 26 | | Standing instruction scope and imports | [instructions](references/instructions.md) | |
| 27 | |
| 28 | Read a page using `read_skill` with `name="reasonix-guide"` and |
| 29 | `reference="references/skills.md"` (substitute the page path). If the tool is |
| 30 | not directly exposed, use: |
| 31 | |
| 32 | ```json |
| 33 | {"action":"call","capability_id":"tool:read_skill","arguments":{"name":"reasonix-guide","reference":"references/skills.md"}} |
| 34 | ``` |
| 35 | |
| 36 | ## Runtime and permissions |
| 37 | |
| 38 | Desktop Settings → Diagnostics opens a static report. Refresh repeats collection; |
| 39 | the optional session-runtime view reads the active tab Host without starting MCP. |
| 40 | The page can copy redacted JSON and link to the relevant settings tab; it never |
| 41 | auto-edits config, executes hooks, or reconnects servers. |
| 42 | |
| 43 | Live probing runs third-party code and may send configured environment/headers. |
| 44 | Use `reasonix doctor capabilities --live --timeout 5s --json` only when starting |
| 45 | those servers is explicitly authorized in the session. A diagnostic request |
| 46 | alone does not authorize configuration changes. |
| 47 | |
| 48 | Keep tokens, header/env values, URL query strings, usernames, and external |
| 49 | machine paths out of reports. Use `<workspace>/…`, `~/…`, or `<external>/…`. |
| 50 |