[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ECSW5715HS7123J85G6FK7":3,"skill-same:01M7ECSW5715HS7123J85G6FK7":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ECSW5715HS7123J85G6FK7","hermes-doctor-triage",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-doctor-triage\u002Fhermes-doctor-triage\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# hermes-doctor-triage\n\n# Hermes Doctor Triage\n\n## When to Use\n\n`hermes doctor` reports issues (config drift warnings, provider key \"invalid\" lines,\nnpm vulnerability counts) that need resolving, not relaying.\n\nFix findings at the root cause. The report text is generated code —\nread the generator, not just the message.\n\n## Step 0: reproduce live, never trust a screenshot transcription\n\nVision transcriptions of terminal screenshots garble provider names, URLs, and issue\nwording. Re-run `hermes doctor` yourself (timeout >= 300s; it makes network probes)\nand triage the live output. Screenshot only tells you the general shape.\n\n## Step 1: trace the finding to its generator\n\nDoctor checks live in `~\u002F.hermes\u002Fhermes-agent\u002Fhermes_cli\u002Fdoctor_*.py` (facade\n`doctor.py` re-exports; `doctor_config.py` = config drift, `doctor_tools.py` = npm\naudit + toolsets, `doctor_connectivity.py` = provider key probes). `grep -rn \"\u003Cissue\nphrase>\" hermes_cli\u002Fdoctor*.py` locates the exact emitter and often the sanctioned fix\npath in its docstring. Issues listed as `manual_issues` are never touched by\n`hermes doctor --fix` — expect to fix them by hand.\n\n## Legacy custom_providers drift (\"the v12 list migration ran once and does not re-fire\")\n\nThe v11->v12 migration (`hermes_cli\u002Fconfig_migrations.py::_migrate_to_12`) moved the\n`custom_providers:` list into `providers:` once at the version bump; entries hand-added\nafterward stay stranded and doctor nags forever. Reuse the migration itself rather than\nhand-converting shapes:\n\n1. Delete broken entries first (e.g. a hand-written duplicate whose `base_url` ends in a\n   stray `\\`) via `read_user_config_raw` + `atomic_config_write` from `hermes_cli.config`\n   — never `yaml.dump` on a config path (CI-linted, destroys comments\u002Fordering).\n2. In a `python3` heredoc with the repo on `sys.path`: `from hermes_cli import\n   config_migrations as m; m._migrate_to_12({}, quiet=True)` — it converts every list\n   entry to the providers shape through the official translator and persists via the\n   sanctioned migration path (keeps `key_env`, `models`, `default_model`, `transport`).\n3. Back up `config.yaml` first; verify with `hermes doctor` (the nag rows disappear)\n   and confirm the running session's own provider survived in `providers:`.\n\n## \"Check \u003CKEY> in .env\" false alarms\n\n`doctor_connectivity.py` probes EVERY registered api_key ProviderProfile's `\u002Fmodels`\nendpoint with the first env var it finds. A regional sibling (e.g. the CN endpoint)\nsharing one key with the intl profile 401s by construction when the key is for the\nother region — the key is fine, the probe is doomed. Verify the key directly first\n(`curl -H \"Authorization: Bearer $KEY\" \u003Cintl>\u002Fmodels` -> 200). Fix without touching the\nrepo: drop an override user-plugin at\n`~\u002F.hermes\u002Fplugins\u002Fmodel-providers\u002F\u003Csame-name>\u002F` (bundled `__init__.py` + `plugin.yaml`\ncopied, `supports_health_check=False` on the doomed regional profiles — doctor then\nreports \"key configured\" and runtime resolution is unchanged; user plugins win on name\ncollision, last-writer-wins). Do NOT edit the bundled plugin in the git tree —\n`hermes update` clobbers it.\n\n## \"Browser tools (agent-browser) has N npm vulnerabilities\"\n\nThe audit runs against the hermes-agent PROJECT_ROOT (`npm audit --workspaces=false`),\nnot the tool dir under `~\u002F.hermes\u002Ftools\u002F` (which has no lockfile — `npm audit` there\nENOLOCKs). `doctor_tools.py::_audit_one` explains the posture: versions come from the\ncommitted lockfile, so a local `npm audit fix` never persists — the next `hermes update`\nreinstalls the pinned state and the finding reappears. The fix is the lockfile bump\nitself: edit the pin in `package.json` (check BOTH `dependencies` and `overrides` —\nthey often pin the same package), then `npm install --package-lock-only --workspaces=false\n--ignore-scripts` followed by `npm install --workspaces=false --ignore-scripts`, verify\n`npm audit` is clean. Tell the user this reverts on the next `hermes update` until\nupstream ships the bump (check `git show origin\u002Fmain:package.json | grep \u003Cpkg>` first —\nif upstream already fixed it, just update).\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fhermes-doctor-triage\u002Fhermes-doctor-triage","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill hermes-doctor-triage",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill hermes-doctor-triage",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill hermes-doctor-triage","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-doctor-triage\u002Fhermes-doctor-triage\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",369,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-doctor-triage\u002Fhermes-doctor-triage\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]