- name
SKILL.md
Beceri dosyası yayıncının deposunda kalır.
Kopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add omagents/omagents --skill doctor -a cursor -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add omagents/omagents --skill doctor -a claude-code -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add omagents/omagents --skill doctor -a codex -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add omagents/omagents --skill doctor -a grok -yKopyalanan mesajı bir Grok Bot sohbetinde gönderin. Bot bu SKILL.md dosyasını GitHub'dan alır ve tüm Bot'larınızın paylaştığı becerilere ekler.
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/doctorYayıncıdan
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.mdGenel bakış
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.
SSS
packages/core/skills/doctor/SKILL.md dosyasını yayıncıdan indirin veya yolu kopyalayıp depoyu açın. PlugMCP beceriyi listeler, dosyayı barındırmaz.
Yayıncı bunu şurada tutuyor: https://github.com/omagents/omagents.
Claude, Cursor, Codex ve Grok Build, yayıncının deposundan eklediğiniz bir SKILL.md dosyasını okuyabilir. Grok Bot, becerinin GitHub klasör bağlantısını bir sohbette gönderdiğinizde onu kurar.
majorMinor