- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add omagents/omagents --skill doctor -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add omagents/omagents --skill doctor -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add omagents/omagents --skill doctor -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add omagents/omagents --skill doctor -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/doctorDe l'éditeur
Verify that OmAgents is correctly installed, configured, and operational.
/doctor or "diagnose"Run each check in order. Report PASS/FAIL for each with a one-line explanation.
Check that @omagents/omagents is in the OpenCode plugin config:
cat ~/.config/opencode/opencode.json
"@omagents/omagents" appears in the plugin arrayEach MCP server should be reachable. Check:
Do NOT probe local (stdio) MCP servers with --help — they ignore the flag
and block on stdin forever. Stdio servers exit cleanly on stdin EOF, so
redirect < /dev/null instead. A cold npx cache can make the first run slow
(package download); that is normal and not a hang.
Report which MCPs are configured and whether the token/key is present.
ls ~/.venvs/omagents/bin/python
~/.venvs/omagents/bin/python -c "import jinja2; print(jinja2.__version__)"
For a project using .omagents/venv, also inspect the overlay:
node <omagents-core>/hooks/project-venv.js ensure --root <project-root> to validate or idempotently repair the overlay. A broken interpreter or Python majorMinor mismatch is a FAIL and must not trigger automatic deletion. Read the versions and site paths directly when diagnosing a failure (use Scripts/python.exe on Windows):
~/.venvs/omagents/bin/python -c "import sys,sysconfig; print('.'.join(map(str,sys.version_info[:2]))); print(sysconfig.get_path('purelib')); print(sysconfig.get_path('platlib'))"
<project-root>/.omagents/venv/bin/python -c "import sys,sysconfig; print('.'.join(map(str,sys.version_info[:2]))); print(sysconfig.get_path('purelib')); print(sysconfig.get_path('platlib'))"
pyvenv.cfg: include-system-site-packages must be false.purelib and confirm omagents-base.pth exists and points to the base purelib/platlib reported by sysconfig. When purelib and platlib differ, both must be present. Compare paths after os.path.normcase(os.path.realpath(...)) normalization.node <omagents-core>/hooks/project-venv.js run --root <project-root> -- -c "import jinja2; print(jinja2.__file__)"
PASS only when the normalized jinja2.__file__ is beneath base purelib/platlib for a base-only package. If the project declares Jinja2 locally, its normalized path must instead be beneath the project purelib, proving the project copy wins.OMAGENTS_PROJECT_ONLY=1 BASE_PURELIB='<base-purelib>' BASE_PLATLIB='<base-platlib>' <project-root>/.omagents/venv/bin/python -c "import os,sys; paths={os.path.normcase(os.path.realpath(p)) for p in sys.path}; assert all(os.path.normcase(os.path.realpath(p)) not in paths for p in [os.environ['BASE_PURELIB'], os.environ['BASE_PLATLIB']])"
On Windows, set all three variables for the command session and use Scripts/python.exe. Also run node <omagents-core>/hooks/project-venv.js pip --root <project-root> -- show jinja2: base-only Jinja2 must be reported as not installed; a project-local copy must have its Location inside the project purelib.Verify the skills directory exists and contains SKILL.md files:
ls <omagents-core>/skills/*/SKILL.md
Verify the shell.env hook is prepending venv and skill scripts:
echo $PATH | tr ':' '\n' | head -10
~/.venvs/omagents/bin appears in PATHecho $OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS
trueCheck if superpowers was loaded successfully by looking for superpowers skills in the available skills list. If superpowers failed to load, the user will see a warning in the OpenCode console.
Check that the user has at least one model configured:
cat ~/.config/opencode/opencode.json
model field is set (e.g., "model": "anthropic/claude-sonnet-4-5")model not set. Tell user to configure a model or use /connect command.small_model is set (used for titles/summaries). If not, suggest setting it to a cheaper model.Present results as a table:
| Check | Status | Notes |
|-------|--------|-------|
| Plugin Registration | PASS | Found in opencode.json |
| MCP: agentmemory | PASS | npx available |
| MCP: codegraph | PASS | npx available |
| MCP: context7 | PASS | Remote reachable |
| MCP: websearch | PASS | Remote reachable |
| MCP: github | FAIL | GITHUB_TOKEN not set, using grep_app fallback |
| Python Venv | PASS | jinja2 3.1.4 |
| Skill Discovery | PASS | 5 skills found |
| PATH Injection | PASS | venv bin in PATH |
| Background Subagents | PASS | Enabled |
If any check fails, provide the exact command to fix it.
Diagnose OmAgents installation and configuration. Trigger when the user says 'doctor', 'diagnose', or encounters issues with MCP servers, skills, venv, or plugin loading. Checks plugin registration, M
---name: doctordescription: Diagnose OmAgents installation and configuration. Trigger when the user says 'doctor', 'diagnose', or…---# packages/core/skills/doctor/SKILL.mdVue d'ensemble
Diagnose OmAgents installation and configuration. Trigger when the user says 'doctor', 'diagnose', or encounters issues with MCP servers, skills, venv, or plugin loading. Checks plugin registration, MCP connectivity, Python venv, skill discovery, and PATH injection.
FAQ
Téléchargez packages/core/skills/doctor/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/omagents/omagents.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.
majorMinor