Agent skill

Omh Doctor

by rlaope in rlaope/oh-my-hermes

[omh] OMH install misbehaving: diagnosing oh-my-hermes installation health.

MITAuto-check passed

Install Omh Doctor

skills CLI
$ npx skills add rlaope/oh-my-hermes --skill omh-doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rlaope/oh-my-hermes omh-doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rlaope/oh-my-hermes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omh-doctor .claude/skills/omh-doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
omh-doctor
GitHub stars
3.2k
Token cost
~1.3k tokens
SKILL.md length
651 words
Files
1
Skills in repo
143
Repo updated
First seen
Licence
MIT

At a glance

[omh] OMH install misbehaving: diagnosing oh-my-hermes installation health.

  • The user says: doctor
  • SKILL.md covers Why This Exists, Do Not Use When, Examples and Completion Checklist, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Installation health

What it does

Omh Doctor is an agent skill from rlaope/oh-my-hermes. [omh] OMH install misbehaving: diagnosing oh-my-hermes installation health. Use when the user says: doctor, diagnose omh, installation health.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: All in one plugin for Hermes Agent ⚚ the coding intelligence, a long-term memory system and model optimized workflow packages. The licence is MIT.

When your agent uses it

  • The user says: doctor
  • Installation health

Example prompts

  • “/omh-doctor”

What it can do on your machine

Read from SKILL.md and the folder at commit 7cd0d02. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Omh Doctor loads about 1.3k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 651 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rlaope/oh-my-hermes at commit 7cd0d02, republished under its MIT licence (© rlaope). 651 words, ~1,328 tokens.

Download SKILL.mdSave it as .claude/skills/omh-doctor/SKILL.md (or your agent's skills folder).
name
omh-doctor
description
[omh] OMH install misbehaving: diagnosing oh-my-hermes installation health. Use when the user says: doctor, diagnose omh, installation health.

Doctor

This is a Hermes-native doctor workflow skill.

Why This Exists

doctor exists to turn confusing install/setup states into grouped, local health evidence and the next repair action without treating a check as a fix.

Do Not Use When

  • The user is asking for a general product explanation rather than local health diagnostics.
  • The requested change is a repository bug fix, not an installed-environment check.
  • The wrapper wants to claim Hermes reload, skill execution, or plugin behavior that was not observed.

Examples

Good example:

  • Prompt: doctor after omh update says setup is next but Hermes skills still look stale.
  • Expected behavior: Inspect managed skills, Hermes registration, runtime state, and next repair action with explicit proof boundaries.
  • Why: The issue is local installation health and needs grouped diagnostic evidence.

Bad example:

  • Prompt: doctor implement a new uninstall command UX.
  • Expected behavior: Route to planning or implementation instead of health diagnostics.
  • Why: That is product development work, not a local health check.

Completion Checklist

  • Command availability, managed skills, Hermes registration, runtime state, and optional surfaces are grouped separately.
  • Blocking issues and warnings are separated, with one next repair action named for each blocking area.
  • Plugin install, plugin import/register smoke, and Hermes runtime load are not collapsed into one claim.
  • The final status says whether setup/update/doctor repaired anything or only observed health.

Recovery Notes

  • If managed skills are stale, recommend omh update or omh setup depending on whether registration also needs repair.
  • If skills.external_dirs or Hermes config is missing, route to setup repair rather than editing hidden runtime state.
  • If plugin register smoke fails, reinstall the plugin bundle with setup --with-plugin --force before claiming plugin readiness.
  • If omh is missing from PATH, use the installer-reported absolute command path and then re-run doctor.

Workflow Lane

  • Current lane: Automation and status (achievements, workspace-audit, production-audit, live-incident-response, automation-blueprint, github-event-ops, github-issue-intake, buzz, +39 more) - schedules, status, health, and ops review.
  • If intent belongs to another lane, hand back to oh-my-hermes or name the adjacent workflow.
  • Shared product, routing, compatibility, and evidence rules: omh-routing/references/skill-common-rail.md.

Use When

Use to diagnose OMH installation and Hermes config registration.

Strong routing signals: `doctor`, `$doctor`, `diagnose omh`, `installation health`
Show full SKILL.md (296 more words)Show less

Catalog Metadata

Category: operator Phase: diagnostics Hermes role: tracker Quality tier: evidence-gated Reasoning demand: light

Quality bar:

  • Name the workflow target, constraints, validation evidence, and stop condition.
  • Separate Hermes guidance from executor or wrapper behavior unless evidence proves the step happened.

Handoff policy:

Run directly as local health inspection; propose executor work only when a repo fix is required.

Required inputs:

  • omh home
  • Hermes home
  • observed issue

Expected outputs:

  • health checks
  • fix guidance
  • known proof boundary

Artifact expectations:

  • doctor state summary when runtime artifacts are writable

Safety rules:

  • Do not imply hidden Hermes runtime behavior.
  • Use the smallest verification that can prove the claim.

Runtime Evidence

Preferred harness for this skill: qa-specialist.

sh
omh runtime record --skill doctor --harness qa-specialist --status started

Record observed delegation results; otherwise return not_available or not_observed. Prepared OMH routing is not execution, review, CI, merge-readiness, or merge evidence.

  • Treat wrapper memory/context summaries as advisory local context, not proof of opaque Hermes memory reads or changes. Preserve workflow intent and stop conditions; verify before claiming completion. Reply in the user's own words and the host's own voice: its SOUL.md persona owns reply language, tone, speech level, and sentence endings, progress updates included (where it sets no language, use the one the user wrote in), and OMH shapes structure and content only; OMH's record terms (surface, lane, wrapper, handoff, evidence boundary, not_observed) stay in records and tool calls, never in the sentence the user reads unless they ask about one; and when a stop condition or a decision the user owns ends the turn, offer the next action as a question rather than declaring what will not be done.

Use Hermes-native subagent/delegation features when available: native subagents -> Hermes delegation when available, otherwise sequential lanes.

Shared product, compatibility, topology, memory, harness, and execution rules: omh-routing/references/skill-common-rail.md. Load it when applicable; otherwise name an unavailable capability.

© rlaope, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/omh-doctor of rlaope/oh-my-hermes.

Open the folder on GitHubat commit 7cd0d02

Compare with similar skills

Omh Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Omh Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Omh Doctor this skillrlaope/oh-my-hermes3.2k—~1.3kAutomated safety check: PassMIT
Diagnosing SDK HealthPostHog/posthog40k—~2.7kAutomated safety check: PassCustom licence
Azure Resource Health Diagnosegithub/awesome-copilot40k1 repos~2.9kAutomated safety check: PassMIT
AWS Resource Health Diagnosegithub/awesome-copilot40k—~1.7kAutomated safety check: PassMIT
Diagnosing Experiment HealthPostHog/posthog40k—~5.9kAutomated safety check: PassCustom licence
Muse Code Product Doctorasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: PassCC0-1.0

Similar skills

  • Diagnosing SDK Health

    PostHog/posthog

    Official

    Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them.

    40k GitHub stars~2.7k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Azure Resource Health Diagnose

    github/awesome-copilot

    Official

    Analyze Azure resource health, diagnose issues from logs and telemetry, and create a remediation plan for identified problems.

    40k GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • AWS Resource Health Diagnose

    github/awesome-copilot

    Official

    Analyze AWS resource health, diagnose issues from CloudWatch logs and metrics, and create a remediation plan for identified problems.

    40k GitHub stars~1.7k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Official

    Runs diagnostics and a health check on one PostHog experiment: its setup, exposures, results and changes during the run.

    40k GitHub stars~5.9k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Muse Code Product Doctor

    asgeirtj/system_prompts_leaks

    Diagnoses a Muse Code installation's own failures from binary and session evidence, instead of treating the report as an ordinary repository bug.

    69k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Hermes Imports

    affaan-m/ECC

    将本地 Hermes 操作员工作流转换为经过清理的 ECC 技能和发布包工件。在准备将 Hermes 工作流用于公共 ECC 重用而不泄露私有工作区状态、凭据或仅本地路径时使用。

    276k GitHub stars~324 tokensUpdated yesterday
    Auto-check passed

More from rlaope/oh-my-hermes

All 143 skills in this repo
  • Omh Accessibility Audit

    rlaope/oh-my-hermes

    [omh] Screen-reader or keyboard accessibility gaps: prepare WCAG, keyboard, focus, screen-reader, target-size, and reflow evidence gates for UI surfaces.

    3.3k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Omh Agent Debug

    rlaope/oh-my-hermes

    [omh] Agent is stuck, looping, or drifting: capture a stuck, looping, drifting, or repeatedly failing agent run, diagnose the likely failure pattern, and prepare the smallest safe recovery action.

    3.3k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Omh Agent Evaluation

    rlaope/oh-my-hermes

    [omh] Choosing between coding agents on evidence: compare executor or agent choices on reproducible tasks using quality, cost, time, tool, and evidence metrics.

    3.3k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Omh Agent Instructions

    rlaope/oh-my-hermes

    [omh] Agent instruction file for a repo -- AGENTS.md, CLAUDE.md, a Cursor rule: write or update what an agent cannot derive from the code, inside a marked region, with every command verified or…

    3.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Omh Agent Ops Review

    rlaope/oh-my-hermes

    [omh] AI agent progress for managers: help managers inspect AI-agent progress, blockers, quality gates, and throughput levers.

    3.3k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Omh AI Slop Cleaner

    rlaope/oh-my-hermes

    [omh] Messy or AI-generated code to clean up: delete AI-generated slop, dead code, and duplication while observable behavior stays identical.

    3.3k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Omh Doctor

What does Omh Doctor do?

[omh] OMH install misbehaving: diagnosing oh-my-hermes installation health. Omh Doctor is an agent skill from rlaope/oh-my-hermes. [omh] OMH install misbehaving: diagnosing oh-my-hermes installation health.

When should I use Omh Doctor?

Omh Doctor fits situations like: the user says: doctor; installation health.

How do I install Omh Doctor in Claude Code?

Run `npx skills add rlaope/oh-my-hermes --skill omh-doctor -a claude-code`. Or copy the skill folder (skills/omh-doctor in rlaope/oh-my-hermes) into .claude/skills/omh-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Omh Doctor in Codex?

Run `npx skills add rlaope/oh-my-hermes --skill omh-doctor -a codex`. Or copy the skill folder (skills/omh-doctor in rlaope/oh-my-hermes) into .agents/skills/omh-doctor in your project. Codex loads it when a task matches its description.

Can I use Omh Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rlaope/oh-my-hermes --skill omh-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omh-doctor, .gemini/skills/omh-doctor, .github/skills/omh-doctor and .opencode/skills/omh-doctor in your project.

What does Omh Doctor need to run?

SKILL.md names no scripts, command-line tools or credentials: Omh Doctor is instructions for the agent only.

Does Omh Doctor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Omh Doctor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Omh Doctor use?

Omh Doctor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Omh Doctor use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Omh Doctor?

Skills that share tags, products or a category with Omh Doctor: Diagnosing SDK Health (PostHog/posthog, 40k stars), Azure Resource Health Diagnose (github/awesome-copilot, 40k stars), AWS Resource Health Diagnose (github/awesome-copilot, 40k stars) and Diagnosing Experiment Health (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Omh Doctor?

rlaope (a GitHub user) maintains it in rlaope/oh-my-hermes, which has 3,243 GitHub stars. The repository holds 143 skills in this directory. The repository was last updated on October 10, 2026.

Source: rlaope/oh-my-hermes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.