doctor
Skill4 starsChanged todayMITView on GitHub
[oh-my-agy] Diagnose and fix oh-my-agy installation, manifest health, and runtime issues (plugin discovery, lifecycle hook wiring, Node availability, rules size, agents and skills integrity, continuation nudges, and stale workflow state); install, enable, update, or uninstall the plugin and bootstrap AGENTS.md (--setup, --init-deep); configure Slack, Discord, Telegram, webhook, or command notifications (--notifications); and audit sessions (--session, --session-compare, --session-scan). Use when hooks, subagents, or continuation are failing or not working.
86 other projects use a version of this.
Adopted by
Most recently taken up by
- aaroncohn/babysittertheir own version, first seen Nov 16, 2026
- timursafiullin/aodtheir own version, first seen Nov 15, 2026
- mkritter3/codex-paired-superpowerstheir own version, first seen Nov 15, 2026
- dcamunas/model-routertheir own version, first seen Nov 15, 2026
- Noah-OS/longhaultheir own version, first seen Nov 15, 2026
- JanSzewczyk/spec-driven-developmenttheir own version, first seen Nov 8, 2026
Used with
Projects with it also use uninstall, mode and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
AnthropicSkilluninstall
Uninstall a community skill that was installed via the hub. Confirms before deleting files, refuses to touch first-party plugin skills, and logs every action. Use when the user wants to fully remove a community skill ("uninstall [skill]", "remove this skill") rather than just disable it.
Also in 6 projects that use this
ibahgatSkillmode
Inspect or switch omi operating mode/profile for speed, depth, autonomy, or strict quality gates.
Also in 3 projects that use this
BlockSkillopen
Open markdown documents in Penpal for collaborative review. Use when you want a human to review a document, plan, or research artifact.
Also in 3 projects that use this
QinghongLinSkilleditor
Read analyst.json and detective.json, make all editorial decisions — what the blog argues, which findings matter, narrative arc and section structure. No visual design. Outputs editor.md (prose) and editor.json (structure with edt_xx IDs).
Also in 3 projects that use this
AnthropicSkillstatus
Case status summary by audience — client-facing (plain language), internal (for the professor), or court-ready (formal caption format per local rules). Same facts, different framing and depth. Use when a student needs to update the client, brief the professor, or prepare a court status report.
Also in 15 projects that use this
MicrosoftSkillinit
Also in 7 projects that use this
Other versions86 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 86
- Yeachan-Heo/oh-my-codex★ 34ksame name
- jihe520/MathModelAgent★ 6.2ksame name
- spotify/portal-ai-plugins★ 2.8ksame name
- fakechris/obsidian_vault_pipeline★ 165same name
- NoobyGains/godmode★ 120same name
- Rich627/whatsapp-claude-plugin★ 114same name
- bluzir/claude-code-design★ 102same name
- jjanczur/tyran★ 79same name
- svy04/ballast★ 73same name
- Hainrixz/agente-pagokit★ 68same name
76 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- rules/AGENTS.mdAGENTS.md
- ai-slop-cleanerSkill
- analyzeSkill
- askSkill
- autopilotSkill
- cancelSkill
- code-reviewSkill
- deep-interviewSkill
- deep-researchSkill
- hudSkill
- loftSkill
- modernizeSkill
- performance-goalSkill
- prSkill
- ralplanSkill
- releaseSkill
- skillSkill
- teamSkill
- threat-modelSkill
- ultragoalSkill
- ultraqaSkill
- visual-ralphSkill
- wikiSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 1 is distinctive, and 6 are very specific to this project.
0
Common
Most of the 65 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Run read-only checks first, report, then remediate only after the user confirms and only for confirmed oh-my-agy-owned targets.
- Distinctive: line 26
If the plugin directory is outside every discovery root, Antigravity will not load it.
- Very specific: line 67
When invoked with --session (or when diagnosing why a workflow drifted, repeated work, or skipped a skill gate), run the 7-dimension …
- Very specific: line 72
Run sh <plugin>/hooks/run.sh session-compare "<baseline>" "<candidate>" [.omagy/artifacts/session-compare-<UTC>.json] to compute …
- Very specific: line 73
Run sh <plugin>/hooks/run.sh session-scan [transcriptOrDir] --json across a transcript file or brain/logs directory for privacy-safe …
- Very specific: line 74
When --export [skeleton|evidence|full] is requested, run the mandatory Two-Pass Redaction & Scrub Audit (<SECRET-n>, <EMAIL-n>, <PERSON-n>, …
- Very specific: line 92
Not discovered: symlink or copy the plugin into a discovery root per $doctor --setup (setup-and-init-deep.md), then restart Antigravity.
“Common” is measured: kept by at least 6 in 10 of the 65 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
oh-my-agy Doctor
Run read-only checks first, report, then remediate only after the user confirms and only for confirmed oh-my-agy-owned targets.
Mode Dispatch
- Health Diagnostics (default
$doctor): inspect discovery roots, manifests, SDO skill compliance, hook selftests, floor-guard, and workspace.omagy/state. - Plugin Setup &
AGENTS.mdBootstrap ($doctor --setup/$doctor --init-deep): install, enable, update, or uninstalloh-my-agyin user or project scope, configure.gitignore, and bootstrap root or hierarchical subdirectoryAGENTS.mdfiles (scanning high-density/high-churn boundaries viash <plugin>/hooks/run.sh init-deep-scan [root] --json) — follow references/setup-and-init-deep.md. - Stop & Idle Notifications (
$doctor --notifications): inspect, configure, smoke-test, or disable Slack, Discord, Telegram, generic HTTPS webhook, or global local-command notifications (~/.gemini/config/oh-my-agy/notifications.jsonand<workspace>/.omagy/notifications.json, enforcing SSRF and global-onlycommand.commandboundaries) — follow notifications.md. - Session Transcript Forensics (
$doctor --session/--session-compare/--session-scan): run 7-lens transcript forensics, baseline-vs-candidate session regression checks, or privacy-safe cross-session orphan tool-call, compaction, and failure-cluster scanning (sh <plugin>/hooks/run.sh session-scan [transcriptOrDir] --json) — follow session-forensics.md.
Locate the plugin
Resolve PLUGIN_DIR from the path of this SKILL.md (two levels up). Check where it is installed:
- workspace:
<repo>/.agents/plugins/oh-my-agy(or.agent/,_agents/,_agent/) - global:
~/.gemini/config/plugins/oh-my-agy - symlinked: report the real path (
readlink -f). On macOS, Antigravity's terminal sandbox denies~/Documents,~/Desktop, and~/Downloads, so a plugin symlinked into those folders is unreadable from sandboxedrun_command.
Sandbox note: Antigravity's terminal sandbox may deny reading this plugin's hooks.json, rules/, agents/, skills/, and hooks/ even from ~/.gemini/config/plugins/oh-my-agy (observed with 0.21.33; the exact rule is unknown). File tools (read_file) are not affected. When a sandboxed shell check fails with Operation not permitted, read the file with read_file instead, or rerun only that command with BypassSandbox: true. This is not a plugin fault: report it as INFO.
If the plugin directory is outside every discovery root, Antigravity will not load it. Report this as CRITICAL.
Checks
| Check | How | Status | |
| Plugin manifest | plugin.json parses via strict JSON.parse() (no // comments), uses only official Antigravity top-level keys (name, displayName, version, description, logo, suggestedPrompts, author, homepage, repository, disabled), has description <= 160 chars, and has version matching the top heading in CHANGELOG.md | CRITICAL if invalid or missing; WARN on version drift or unknown keys | |
| Enabled | Antigravity's plugin list (GetAllPlugins; see the built-in plugin skill) shows oh-my-agy enabled with skills, agents, rules, and hooks | CRITICAL if missing; WARN if disabled | |
| Name collisions | other plugins/skills named code-review, team, skill, pr, ... at a higher priority shadow ours | WARN | |
| Rules & hook sizes | only rules/AGENTS.md exists in rules/ (no duplicate .md files), wc -c rules/AGENTS.md < 24000 bytes, hooks/omagy-hook.mjs < 170000 bytes (< 175000 hard ceiling, with zero static import of omagy-skill.mjs, omagy-cli.mjs, or omagy-selftest.mjs), hooks/omagy-cli.mjs < 93734 bytes, and sidecars/hud/{ui,client}.mjs each < 256000 bytes | WARN if duplicate rule files or over byte ceilings | |
| Skills, SDO & routing eval | sh "<PLUGIN_DIR>/hooks/run.sh" skill-validate "<PLUGIN_DIR>/skills" --strict --json exits 0 (ok: true, errors: [], warnings: [] across all 23 skills: SKILL.md <= 19000 bytes, references/*.md < 40000 bytes 1-level deep with > 100-line TOCs, valid YAML frontmatter without -> or HTML tags, valid .md#anchor & scripts/* links, zero clutter/Trojan Unicode/HTML-comment injections/unpinned remote execs/corrupt assets), .agents/skills.json passes skill-validate when present, and sh "<PLUGIN_DIR>/hooks/run.sh" skill-eval --min-rank1 95 exits 0 (0 cosine collisions, 100% negative survival) | CRITICAL per broken skill or routing/collision failure | |
| Agents | every agents/*.md has name, description, subagent, mainAgent, and tools (18 roles total) and no unrecognized top-level frontmatter keys such as level | CRITICAL per broken agent; WARN on unknown frontmatter keys | |
| Hooks JSON & symlinks | hooks.json parses; commands reference ./hooks/run.sh; PreToolUse matcher covers write_file, edit_file, apply_patch, and read_file; no broken/dangling symlinks in hooks/ | CRITICAL if invalid or dangling symlink | |
| HUD Sidecar | sidecars/hud/sidecar.json parses with has_web_ui: true and SIDECAR_UI_ENTRYPOINT_AUX_PANE, and sh "<PLUGIN_DIR>/sidecars/hud/run.sh" selftest prints "selftest":"PASS" (H1–H29, including vm.Script inline script compilation, worktrees snapshot, omagy-loft-error bridge, crash guards, and Desktop HUD daemon/dispatch checks) | WARN if missing or failing | |
| Cross-host bundles (Claude / Codex, Experimental) | On Claude Code or OpenAI Codex hosts, run `sh "<PLUGIN_DIR>/hooks/run.sh" host-validate <claude | codex> [<bundleDir>] [--workspace <dir>] [--codex-home <dir>] --strict --json(omitting<bundleDir>validates the default user/workspace bundle), checkhost-bundle.jsonfor version drift against<PLUGIN_DIR>/plugin.json, verify Codex /hooksapproval status (never forge[hooks.state]), and inspect OMAGY_DESKTOP_HUD (1forces Desktop daemon outside CLI/IDE/CI;0` disables) | CRITICAL on invalid host bundle; INFO on /hooks approval or Desktop gate |
| Node | cd /tmp && sh "<PLUGIN_DIR>/hooks/run.sh" selftest prints {"selftest":"PASS","passed":96,"failed":0} (runs offline in a temp dir across T1–T10 and T20–T61). If the sandbox denies it, rerun this one command with BypassSandbox: true | CRITICAL if node is missing or the selftest fails | |
| Floor guard, audit CLIs & quality gates | sh "<PLUGIN_DIR>/hooks/run.sh" floor-guard "<workspace>" exits 0 (1 on 10-category anti-tampering violations including secret-in-diff; 2 outside a git worktree), sh "<PLUGIN_DIR>/hooks/run.sh" tmpdir-audit --json passes 0o700 UID-scoped runtime dir checks, read-only repo checks (docs-drift, coverage-map, dep-license-diff, mcp-audit, wiki-lint with isolatedPages: []) pass, and if .omagy/config.json defines qualityGates, sh "<PLUGIN_DIR>/hooks/run.sh" quality-gates "<workspace>" returns "ok":true (use quality-gate <report.json...> for semgrep/axe scanner JSON reports) | WARN if floor violations, audit failures, or invalid gate config | |
| Live hooks | $XDG_RUNTIME_DIR/oh-my-agy/<conversationId>.routing.json or $TMPDIR/oh-my-agy-<uid>/<conversationId>.routing.json (0o700 UID-scoped; HUD also checks legacy same-UID $TMPDIR/oh-my-agy when OMAGY_RUNTIME_DIR is unset) exists and matches the latest user prompt | WARN if missing or stale | |
| Hook PATH | if the selftest passes in your shell but hooks never fire, Antigravity's hook shell may lack nvm/homebrew in PATH. Set OMAGY_NODE or check that run.sh finds Node | WARN | |
| Workspace & inner-folder state | .omagy/state/*-state.json parse at the parent workspace root and any discovered inner-folder <subfolder>/.omagy/ scopes; list active modes, awaiting_confirmation holds, and scopes; flag stale (>6h), terminal-but-active, or orphaned team boards (sh "<PLUGIN_DIR>/hooks/run.sh" validate-team-tasks "<workspace>" "<team>") | WARN | |
Runtime storage & .tmp hygiene | .omagy/ total size is within budget (< 50 MB warn threshold) and no orphaned <file>.tmp.<pid> files from dead PIDs remain in .omagy/ | WARN if oversized or orphan .tmp files exist | |
| Gitignore | .omagy/ is in .gitignore | INFO | |
| Notifications | config JSON parses and passes SSRF/scope rules (see notifications.md) | WARN if invalid |
Command sketch:
P="<PLUGIN_DIR>"
node -e "for (const f of process.argv.slice(1)) JSON.parse(require('fs').readFileSync(f,'utf8'))" "$P/plugin.json" "$P/hooks.json" && echo manifests OK
wc -c "$P/rules/AGENTS.md"
for f in "$P"/skills/*/SKILL.md; do d=$(basename "$(dirname "$f")"); n=$(sed -n 's/^name: *//p' "$f" | head -1); [ "$d" = "$n" ] || echo "MISMATCH $f ($n)"; done
for f in "$P"/agents/*.md; do grep -q '^name:' "$f" && grep -q '^description:' "$f" || echo "BAD AGENT $f"; done
sh "$P/hooks/run.sh" selftest
sh "$P/hooks/run.sh" skill-validate "$P/skills" --strict
sh "$P/hooks/run.sh" skill-eval --min-rank1 95
sh "$P/hooks/run.sh" floor-guard .
sh "$P/hooks/run.sh" tmpdir-audit --json
ls -la .omagy/state 2>/dev/nullSession Transcript Forensics, Clustering & A/B Comparison ($doctor --session / --session-compare / --session-scan)
When invoked with --session (or when diagnosing why a workflow drifted, repeated work, or skipped a skill gate), run the 7-dimension transcript forensics protocol in session-forensics.md:
- Resolve the transcript via
$TMPDIR/oh-my-agy-<uid>/<conversationId>.routing.json(transcriptPath) or<appDataDir>/brain/<conversationId>/.system_generated/logs/transcript.jsonl. - Enforce the Context-Safety Protocol (
wc -lc, checking lines> 100 KB, extracting line numbers and metadata before reading step fields). - Evaluate the 7 behavioral lenses (
skill-timeline,plan-adherence,repeated-work,stumbles,quality-evidence,request-conflicts,cost-and-time) with[line N / step S]citations. - Comparative Session Analysis (
$doctor --session-compare <baseline.jsonl> <candidate.jsonl>) & Multi-Session Clustering ($doctor --session-scan [transcriptOrDir]):- Run
sh <plugin>/hooks/run.sh session-compare "<baseline>" "<candidate>" [.omagy/artifacts/session-compare-<UTC>.json]to compute deterministic deltas acrossduration_ms,turns,tool_calls,failed_tools,stumbles,repeated_work(files read>= 3x), andcompactions(byToolcall/failure breakdown) and classifyassessment.statusasno_regression | regression | inconclusive. - Run
sh <plugin>/hooks/run.sh session-scan [transcriptOrDir] --jsonacross a transcript file or brain/logs directory for privacy-safe aggregate diagnostics (filesScanned,totalSteps,compactions,orphanToolCalls,failedToolCalls, andtopFailureClusterswith home paths and UUIDs scrubbed, never echoing raw user prompts).
- Run
- When
--export [skeleton|evidence|full]is requested, run the mandatory Two-Pass Redaction & Scrub Audit (<SECRET-n>,<EMAIL-n>,<PERSON-n>,<HOST-n>,<REPO-n>) before writing.omagy/artifacts/session-forensics-<id>-<UTC>.md.
Report contract
## oh-my-agy Doctor Report
### Summary
[HEALTHY / ISSUES FOUND]
### Checks
| Check | Status | Details |
### Issues Found
1. ...
### Recommended Fixes
...Remediation (after confirmation)
- Not discovered: symlink or copy the plugin into a discovery root per
$doctor --setup(setup-and-init-deep.md), then restart Antigravity. - Disabled: enable it via the built-in
pluginskill flow (language-serverJetboxWriteState) or link[oh-my-agy](customization://oh-my-agy)(neverplugin://). Do not hand-editconfig.json. - Stale or corrupt state:
$cancel --force <mode>(exact file only). - Restart Antigravity after plugin file changes, and report before/after evidence (including
[oh-my-agy](customization://oh-my-agy)and[oh-my-agy HUD](sidecar://oh-my-agy/hud/)when the sidecar is enabled).
Exit conditions
Report HEALTHY only when discovery, manifest, skills, agents, hooks JSON, the Node selftest, and workspace state all pass. Otherwise report ISSUES FOUND with the exact failing evidence and the smallest confirmed remediation. Never claim a fix from a recommendation alone.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

