hermes-agent/optional-skills/research
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
..
bioinformatics feat: add bioinformatics gateway skill 2026-03-21 16:15:24 -07:00
domain-intel feat(gateway): skill-aware slash commands, paginated /commands, Telegram 100-cap (#3934) 2026-03-30 10:57:30 -07:00
drug-discovery feat(skills): add drug-discovery optional skill — ChEMBL, PubChem, OpenFDA, ADMET analysis 2026-04-13 23:03:08 -07:00
duckduckgo-search Update SKILL.md 2026-04-20 04:15:04 -07:00
gitnexus-explorer Add gitnexus-explorer optional skill (#5208) 2026-04-05 03:00:19 -07:00
parallel-cli fix(skills): move parallel-cli to optional-skills (#3673) 2026-03-28 23:45:05 -07:00
qmd feat: add qmd optional skill — local knowledge base search 2026-03-07 20:39:05 -08:00
scrapling feat(skills): add SiYuan Note and Scrapling as optional skills (#3742) 2026-03-29 09:34:56 -07:00
searxng-search feat(skills): gate 7 Linux/macOS-only skills from Windows via platforms frontmatter 2026-05-08 08:27:23 -07:00