- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill doctor -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill doctor -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill doctor -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill doctor -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/doctor來自發布者
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.md總覽
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.
常見問題
從發布者下載 packages/core/skills/doctor/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/omagents/omagents。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。
majorMinor