hermes-agent/website/docs
Teknium fcd1645223
feat(skills): support external skill directories via config (#3678)
Add skills.external_dirs config option — a list of additional directories
to scan for skills alongside ~/.hermes/skills/. External dirs are read-only:
skill creation/editing always writes to the local dir. Local skills take
precedence when names collide.

This lets users share skills across tools/agents without copying them into
Hermes's own directory (e.g. ~/.agents/skills, /shared/team-skills).

Changes:
- agent/skill_utils.py: add get_external_skills_dirs() and get_all_skills_dirs()
- agent/prompt_builder.py: scan external dirs in build_skills_system_prompt()
- tools/skills_tool.py: _find_all_skills() and skill_view() search external dirs;
  security check recognizes configured external dirs as trusted
- agent/skill_commands.py: /skill slash commands discover external skills
- hermes_cli/config.py: add skills.external_dirs to DEFAULT_CONFIG
- cli-config.yaml.example: document the option
- tests/agent/test_external_skills.py: 11 tests covering discovery, precedence,
  deduplication, and skill_view for external skills

Requested by community member primco.
2026-03-29 00:33:30 -07:00
..
developer-guide docs: document credential file passthrough and env var forwarding for remote backends (#3677) 2026-03-29 00:16:34 -07:00
getting-started feat: add Hugging Face as a first-class inference provider (#3419) 2026-03-27 12:41:59 -07:00
guides fix(gateway): inject PATH + VIRTUAL_ENV into launchd plist for macOS service (#3585) 2026-03-28 14:23:26 -07:00
reference docs(skills): clarify DuckDuckGo runtime requirements (#3680) 2026-03-29 00:17:57 -07:00
user-guide feat(skills): support external skill directories via config (#3678) 2026-03-29 00:33:30 -07:00
index.md docs(voice): add comprehensive voice mode guide 2026-03-14 09:50:45 -07:00