hermes - 💡(How to fix) Fix [IMPROVEMENT] Skills in ~/.hermes/skills/ are unversioned hand-edited markdown [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#20352Fetched 2026-05-06 06:37:11
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
labeled ×3

Root Cause

Problem: Skills stored in ~/.hermes/skills/ are hand-edited markdown files with no version history, no diff capability, and no rollback path. A bad skill patch silently corrupts future agent behavior — the agent just loads the wrong skill without warning. This is especially risky because skills encode exact tool commands, pitfalls, workflow conventions, and user preferences.

Fix Action

Fix / Workaround

Problem: Skills stored in ~/.hermes/skills/ are hand-edited markdown files with no version history, no diff capability, and no rollback path. A bad skill patch silently corrupts future agent behavior — the agent just loads the wrong skill without warning. This is especially risky because skills encode exact tool commands, pitfalls, workflow conventions, and user preferences.

RAW_BUFFERClick to expand / collapse

Severity: Medium

Problem: Skills stored in ~/.hermes/skills/ are hand-edited markdown files with no version history, no diff capability, and no rollback path. A bad skill patch silently corrupts future agent behavior — the agent just loads the wrong skill without warning. This is especially risky because skills encode exact tool commands, pitfalls, workflow conventions, and user preferences.

Proposed fix options:

  1. Git-backed skills — make ~/.hermes/skills/ a git repo and commit on every skill write
  2. Skill versioning in Mnemosyne — store skill versions as memories with timestamps, allow rollback via skill_manage
  3. Signed skills — HMAC-tag skill content to detect silent corruption

Option 1 is simplest to implement; Option 2 leverages existing Mnemosyne infrastructure.

extent analysis

TL;DR

Implementing Git-backed skills by making ~/.hermes/skills/ a git repository and committing on every skill write is the most straightforward approach to address the issue of silently corrupted skills.

Guidance

  • Consider the trade-offs between the proposed fix options, weighing the simplicity of Git-backed skills against the infrastructure leverage of Skill versioning in Mnemosyne.
  • Evaluate the potential benefits of Signed skills for detecting corruption, but also consider the added complexity of implementing and managing HMAC tags.
  • Assess the existing version control and backup processes for ~/.hermes/skills/ to determine if any partial solutions are already in place.
  • Before implementing any solution, ensure that the chosen approach aligns with the overall system architecture and security requirements.

Example

No code snippet is provided due to the high-level nature of the issue and proposed solutions.

Notes

The choice of solution may depend on factors not mentioned in the issue, such as the specific requirements for skill management, the existing development workflow, and the security standards that must be met.

Recommendation

Apply the Git-backed skills workaround, as it is the simplest to implement and provides a straightforward version history and rollback path for skills.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING