Skip to content

v1.24.0

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Apr 10:20
bf6ec90

Headline: Native Hermes Agent support

Hermes Agent by Nous Research landed this February and crossed 100K stars in weeks. It ships with first-class skills at ~/.hermes/skills/ and self-evolving skill generation. Until now, using SkillKit with Hermes meant hacking the Claude adapter or writing skills twice.

v1.24.0 ends that. Hermes is a first-class target alongside Claude Code, Cursor, and Codex.

What you get

  • One-command install. skillkit sync --agent hermes writes skills to .hermes/skills/ (project) or ~/.hermes/skills/ (global). Detection auto-triggers when SkillKit sees a .hermes/ directory or Hermes' AGENTS.md.
  • Idempotent AGENTS.md updates. SkillKit wraps its skill manifest in <!-- SKILLS_TABLE_START --> markers inside Hermes' AGENTS.md. Your mission, SOUL, and custom rules stay untouched. Re-running skillkit sync rewrites only the managed block.
  • Proper XML parsing. The Hermes adapter scopes <name> tag matching to the managed block. No false positives from <mission><name>...</name> or other tags in your AGENTS.md.
  • Translate any skill to Hermes format. skillkit translate <skill> --to hermes produces a valid SKILL.md in .hermes/skills/. All 15K+ marketplace skills work.
  • Slash commands. .hermes/commands/ generation via skillkit command generate --agent hermes.
  • Primer support. skillkit primer emits Hermes-specific AGENTS.md scaffolding with the right section order (overview, stack, commands, conventions, structure, guidelines).

Under the hood

17 integration touchpoints wired: agent registry, discovery paths, translator format map, command generator, primer templates, sync markers, MCP runtime discovery (.hermes/skills in AGENT_DIR_MAP), and dual-source parity between packages/ and legacy src/ trees. 23+ new adapter tests in packages/agents/src/__tests__/adapters.test.ts.

Huge thanks to @RUFFY-369 for authoring the adapter in #114.

Also in this release

OpenClaw alignment with upstream (#117)

OpenClaw's config was drifting from the real openclaw/openclaw layout. Fixed:

Field Before Now
skillsDir skills .openclaw/skills
configFile CLAUDE.md AGENTS.md
globalSkillsDir ~/.openclaw/skills ~/.openclaw/workspace/skills
openclaw.json detection missed via new altConfigFiles

Back-compat preserved — the old bare skills/ path stays in altSkillsDirs so projects installed pre-1.24.0 keep working.

Discovery plumbing fixes

  • SKILL_DISCOVERY_PATHS now includes .hermes/skills and .openclaw/skills. Before this fix, findAllSkills would walk past them silently.
  • getSearchDirs() respects globalSkillsDir instead of deriving home paths from skillsDir. The right location for Hermes (~/.hermes/skills) and OpenClaw (~/.openclaw/workspace/skills) now gets searched.
  • New AgentDirectoryConfig.altConfigFiles schema so agents with multiple marker files (like OpenClaw's openclaw.json) get detected reliably.

Release mechanics

  • packages/mcp and packages/api were drifting from the release train. bump-version.sh now covers them.
  • Regenerated assets/tags/v1.24.0.svg and fresh banner (docs/img/banner.svg) with Zinc palette and gradient accent on the agent count.

Agent count: 46

Agent Format Project dir Global dir
Hermes Agent SKILL.md .hermes/skills/ ~/.hermes/skills/
OpenClaw SKILL.md .openclaw/skills/ ~/.openclaw/workspace/skills/
...44 others

Full list: https://github.com/rohitg00/skillkit#supported-agents

Upgrade

npm i -g skillkit@1.24.0

Then in a Hermes-managed project:

skillkit add <source>                 # install skills
skillkit sync --agent hermes          # write to .hermes/skills + AGENTS.md
skillkit translate <skill> --to hermes

Full changelog

v1.23.0...v1.24.0