- 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.
FAQ
게시자에게서 packages/core/skills/doctor/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/omagents/omagents에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.
majorMinor