- 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