hermes-agent/optional-skills
Teknium 3e823d5b3e feat(skills): gate 7 Linux/macOS-only skills from Windows via platforms frontmatter
Hermes's skill loader (agent/skill_utils.skill_matches_platform) already honors
the 'platforms:' frontmatter field and skip-loads skills whose declared
platform list doesn't include sys.platform. Seven bundled skills are in fact
Linux/macOS-only but never declared it, so they leak into Windows skill
listings and sometimes load with broken instructions.

Audited all 160 SKILL.md files (skills/ + optional-skills/) for Windows-
hostile signals: apt-get/brew/systemd/chmod+x install flows, ptrace/proc
runtime dependencies, bash-only launcher scripts, and package dependencies
with no Windows build. The 7 below fail one or more of those tests in a way
that fundamentally can't be papered over by docs edits:

  minecraft-modpack-server      bash start.sh + chmod +x + apt openjdk
  evaluating-llms-harness       lm-eval-harness bash launcher scripts
  distributed-llm-pretraining-
  torchtitan                    bash multi-node torchrun launcher
  python-debugpy                remote attach relies on /proc ptrace_scope
  pytorch-fsdp                  NCCL backend; Windows path is WSL only
  tensorrt-llm                  NVIDIA TensorRT-LLM has no Windows build
  searxng-search                Docker volume flow assumes POSIX $(pwd)

All seven get 'platforms: [linux, macos]'. On Windows the loader now skips
them silently — no more phantom skill listings, no more mid-task failures
because an Apple-only path was surfaced as a suggestion.

Cross-platform skills that merely CONTAIN signals in examples or
install-instructions (brew install as one of several paths, /tmp/ in a code
snippet, etc.) are NOT touched by this commit. A broader audit that
declares the ~140 cross-platform skills as 'platforms: [linux, macos,
windows]' can follow as a separate change once each has been verified
working on Windows.

The installed user copies under ~/AppData/Local/hermes/skills/ (when they
exist) are also patched so the running session reflects the gating
immediately, but only the in-repo files are committed here.
2026-05-08 08:27:23 -07:00
..
autonomous-ai-agents feat(honcho): wizard cadence default 2, surface reasoning level, backwards-compat fallback 2026-04-18 22:50:55 -07:00
blockchain feat: add Base blockchain optional skill 2026-03-17 01:50:03 -07:00
communication feat(skills): add one-three-one-rule communication skill (#3797) 2026-03-29 15:25:12 -07:00
creative docs(skill): add hyperframes inspect command to cli.md + SKILL.md 2026-05-04 14:13:17 -07:00
devops feat(plugins): convert disk-guardian skill into a bundled plugin 2026-04-20 04:46:45 -07:00
dogfood feat(skills): add adversarial-ux-test optional skill 2026-04-21 01:51:20 -07:00
email/agentmail fix: correct agentmail skill — API key goes in config.yaml env block 2026-03-08 23:34:50 -07:00
finance feat(optional-skills): port Anthropic financial-services skills as optional finance bundle (#21180) 2026-05-07 04:58:39 -07:00
health feat(skills): add fitness-nutrition skill to optional-skills 2026-04-13 22:10:00 -07:00
mcp skills: move 7 niche mlops/mcp skills to optional (#12474) 2026-04-19 05:14:17 -07:00
migration fix(paths): route achievements plugin + profile-tui through HERMES_HOME 2026-04-30 23:21:54 -07:00
mlops feat(skills): gate 7 Linux/macOS-only skills from Windows via platforms frontmatter 2026-05-08 08:27:23 -07:00
productivity feat(skills): add shop-app personal shopping assistant (optional) (#20702) 2026-05-06 04:47:56 -07:00
research feat(skills): gate 7 Linux/macOS-only skills from Windows via platforms frontmatter 2026-05-08 08:27:23 -07:00
security feat(skills): add Sherlock OSINT username search skill 2026-03-17 02:48:21 -07:00
web-development feat(optional-skills): add page-agent skill under new web-development category (#13976) 2026-04-22 04:54:26 -07:00
DESCRIPTION.md fix: review fixes — path traversal guard, trust_style consistency, edge cases 2026-03-06 01:40:01 -08:00