Skip to content

feat: add native Hermes Agent support#4

Open
YanxiangAo wants to merge 1 commit into
XBuilderLAB:mainfrom
YanxiangAo:main
Open

feat: add native Hermes Agent support#4
YanxiangAo wants to merge 1 commit into
XBuilderLAB:mainfrom
YanxiangAo:main

Conversation

@YanxiangAo

Copy link
Copy Markdown

Summary

This PR adds first-class support for Hermes Agent, an open-source AI agent framework that supports nested skill directories and native / discovery.

What changed

New file:

  • Symlinks the entire repo to
  • Hermes' skill discovery automatically finds all 6 sub-skills under via the category
  • No copying of or resource symlinks needed — Hermes preserves the original relative path structure (, etc.)

Updated:

  • Added Hermes Agent installation section alongside Claude Code and Codex
  • Updated the note to mention Hermes also ignores Claude-only fields

Updated: all 6 files

  • Extended cross-platform notes to document Hermes behavior:
    • Resource paths: Hermes keeps original relative paths (no symlink needed)
    • Web tools: mapped / → /
    • : explicitly noted as Claude-only, ignored by Hermes

Why this approach

Hermes' skill system uses structure and supports nested directories. This means the entire repo can be registered as a single category, and all 6 sub-skills are auto-discovered. Unlike Codex (which needs per-skill symlinks), Hermes handles the original relative paths natively.

All three installs (Claude Code / Codex / Hermes) are mutually compatible and can coexist.

Tested

  • runs cleanly and symlinks correctly
  • discovers all 6 sub-skills under category
  • reads via relative path
  • No conflicts with existing Claude Code / Codex installations

cc @XBuilderLAB

- Add install-hermes.sh: symlink entire repo to ~/.hermes/skills/cheat-on-money/
  Hermes supports nested skill directories, so all relative paths
  (../../shared-references/, etc.) resolve correctly without copying.
- Update README.md: add Hermes installation section, note that
  Claude Code / Codex / Hermes installs can coexist.
- Update all 6 SKILL.md cross-platform notes:
  - Document Hermes resource path behavior
  - Map Hermes web_search/web_extract equivalents
  - Note that allowed-tools is Claude-only, Hermes ignores it.

Refs: Hermes skill discovery uses category/<name>/SKILL.md structure.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant