From 3e823d5b3e3ce13bcc06b6233de291325c6dd926 Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Fri, 8 May 2026 08:27:23 -0700 Subject: [PATCH] feat(skills): gate 7 Linux/macOS-only skills from Windows via platforms frontmatter MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- optional-skills/mlops/pytorch-fsdp/SKILL.md | 1 + optional-skills/mlops/tensorrt-llm/SKILL.md | 1 + optional-skills/mlops/torchtitan/SKILL.md | 1 + optional-skills/research/searxng-search/SKILL.md | 1 + skills/gaming/minecraft-modpack-server/SKILL.md | 1 + skills/mlops/evaluation/lm-evaluation-harness/SKILL.md | 1 + skills/software-development/python-debugpy/SKILL.md | 1 + 7 files changed, 7 insertions(+) diff --git a/optional-skills/mlops/pytorch-fsdp/SKILL.md b/optional-skills/mlops/pytorch-fsdp/SKILL.md index 9e16f446ff..680f1791f6 100644 --- a/optional-skills/mlops/pytorch-fsdp/SKILL.md +++ b/optional-skills/mlops/pytorch-fsdp/SKILL.md @@ -5,6 +5,7 @@ version: 1.0.0 author: Orchestra Research license: MIT dependencies: [torch>=2.0, transformers] +platforms: [linux, macos] metadata: hermes: tags: [Distributed Training, PyTorch, FSDP, Data Parallel, Sharding, Mixed Precision, CPU Offloading, FSDP2, Large-Scale Training] diff --git a/optional-skills/mlops/tensorrt-llm/SKILL.md b/optional-skills/mlops/tensorrt-llm/SKILL.md index 056511699e..c5a90ee0e8 100644 --- a/optional-skills/mlops/tensorrt-llm/SKILL.md +++ b/optional-skills/mlops/tensorrt-llm/SKILL.md @@ -5,6 +5,7 @@ version: 1.0.0 author: Orchestra Research license: MIT dependencies: [tensorrt-llm, torch] +platforms: [linux, macos] metadata: hermes: tags: [Inference Serving, TensorRT-LLM, NVIDIA, Inference Optimization, High Throughput, Low Latency, Production, FP8, INT4, In-Flight Batching, Multi-GPU] diff --git a/optional-skills/mlops/torchtitan/SKILL.md b/optional-skills/mlops/torchtitan/SKILL.md index f7dcc60ff6..97dc925fc1 100644 --- a/optional-skills/mlops/torchtitan/SKILL.md +++ b/optional-skills/mlops/torchtitan/SKILL.md @@ -5,6 +5,7 @@ version: 1.0.0 author: Orchestra Research license: MIT dependencies: [torch>=2.6.0, torchtitan>=0.2.0, torchao>=0.5.0] +platforms: [linux, macos] metadata: hermes: tags: [Model Architecture, Distributed Training, TorchTitan, FSDP2, Tensor Parallel, Pipeline Parallel, Context Parallel, Float8, Llama, Pretraining] diff --git a/optional-skills/research/searxng-search/SKILL.md b/optional-skills/research/searxng-search/SKILL.md index c2d170591b..07e32c0b9c 100644 --- a/optional-skills/research/searxng-search/SKILL.md +++ b/optional-skills/research/searxng-search/SKILL.md @@ -4,6 +4,7 @@ description: Free meta-search via SearXNG — aggregates results from 70+ search version: 1.0.0 author: hermes-agent license: MIT +platforms: [linux, macos] metadata: hermes: tags: [search, searxng, meta-search, self-hosted, free, fallback] diff --git a/skills/gaming/minecraft-modpack-server/SKILL.md b/skills/gaming/minecraft-modpack-server/SKILL.md index e307f72f4f..0164f7ed9b 100644 --- a/skills/gaming/minecraft-modpack-server/SKILL.md +++ b/skills/gaming/minecraft-modpack-server/SKILL.md @@ -2,6 +2,7 @@ name: minecraft-modpack-server description: "Host modded Minecraft servers (CurseForge, Modrinth)." tags: [minecraft, gaming, server, neoforge, forge, modpack] +platforms: [linux, macos] --- # Minecraft Modpack Server Setup diff --git a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md index ab0325bd4f..79c59f1e34 100644 --- a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md +++ b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md @@ -5,6 +5,7 @@ version: 1.0.0 author: Orchestra Research license: MIT dependencies: [lm-eval, transformers, vllm] +platforms: [linux, macos] metadata: hermes: tags: [Evaluation, LM Evaluation Harness, Benchmarking, MMLU, HumanEval, GSM8K, EleutherAI, Model Quality, Academic Benchmarks, Industry Standard] diff --git a/skills/software-development/python-debugpy/SKILL.md b/skills/software-development/python-debugpy/SKILL.md index b70fdda4b1..e16ab8bc28 100644 --- a/skills/software-development/python-debugpy/SKILL.md +++ b/skills/software-development/python-debugpy/SKILL.md @@ -4,6 +4,7 @@ description: "Debug Python: pdb REPL + debugpy remote (DAP)." version: 1.0.0 author: Hermes Agent license: MIT +platforms: [linux, macos] metadata: hermes: tags: [debugging, python, pdb, debugpy, breakpoints, dap, post-mortem]