fix(hermes): align with Hermes Agent conventions per docs review

Four fixes from review of hermes-agent.nousresearch.com docs:

1. SKILL.md frontmatter now declares `version` (required field per
   Hermes spec). Plumbed through `convertClaudeCommandToClaudeSkill`
   gated on runtime='hermes' so other runtimes' frontmatter is unchanged.

2. Project-context filename rewrite changed from `HERMES.md` (not
   discovered by Hermes) to `.hermes.md` (top of Hermes' discovery list:
   .hermes.md → AGENTS.md → CLAUDE.md → .cursorrules).

3. README + finishInstall now show `/gsd-help` and `/gsd-new-project`
   for Hermes; per docs, Hermes auto-exposes skills as slash commands.

4. Hermes tests now parse SKILL.md frontmatter structurally via the
   shared parseFrontmatter helper instead of substring-matching source
   text, and assert the version/name/description shape required by
   Hermes' skill_view().

Full suite: 6128/6128 pass (3 new structural assertions).

tests/hermes-install.test.cjs

@@ -5,7 +5,8 @@ const assert = require('node:assert/strict');
 const fs = require('node:fs');
 const path = require('node:path');
 const os = require('node:os');
-const { createTempDir, cleanup } = require('./helpers.cjs');
+const { createTempDir, cleanup, parseFrontmatter } = require('./helpers.cjs');
+const pkg = require('../package.json');
 
 const {
   getDirName,
@@ -109,6 +110,58 @@ describe('Hermes Agent local install/uninstall', () => {
     assert.ok(!fs.existsSync(path.join(targetDir, 'skills', 'gsd-help')), 'Hermes skill directory removed');
     assert.ok(!fs.existsSync(path.join(targetDir, 'get-shit-done')), 'get-shit-done removed');
   });
+
+  test('installed SKILL.md frontmatter conforms to Hermes spec', () => {
+    install(false, 'hermes');
+    const targetDir = path.join(tmpDir, '.hermes');
+    const skillsDir = path.join(targetDir, 'skills');
+    const skillDirs = fs.readdirSync(skillsDir, { withFileTypes: true })
+      .filter(e => e.isDirectory() && e.name.startsWith('gsd-'))
+      .map(e => e.name);
+
+    assert.ok(skillDirs.length > 0, 'at least one gsd-* skill installed');
+
+    // Parse every SKILL.md and assert structural shape required by Hermes.
+    for (const dir of skillDirs) {
+      const content = fs.readFileSync(path.join(skillsDir, dir, 'SKILL.md'), 'utf8');
+      const fm = parseFrontmatter(content);
+      assert.strictEqual(fm.name, dir, `${dir}/SKILL.md name matches dir`);
+      assert.ok(typeof fm.description === 'string' && fm.description.length > 0,
+        `${dir}/SKILL.md has non-empty description`);
+      assert.strictEqual(fm.version, pkg.version,
+        `${dir}/SKILL.md declares version ${pkg.version} (got ${JSON.stringify(fm.version)})`);
+    }
+
+    uninstall(false, 'hermes');
+  });
+
+  test('replaces CLAUDE.md references with .hermes.md (Hermes-discovered project context name)', () => {
+    install(false, 'hermes');
+    const targetDir = path.join(tmpDir, '.hermes');
+    const skillsDir = path.join(targetDir, 'skills');
+
+    // Walk all skill files and confirm no `CLAUDE.md` token leaks; if any
+    // skill body referenced project context, it should now point at
+    // `.hermes.md` (per https://hermes-agent.nousresearch.com/docs).
+    let referencedHermesMd = false;
+    const walk = (dir) => {
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) { walk(full); continue; }
+        if (!entry.name.endsWith('.md')) continue;
+        const content = fs.readFileSync(full, 'utf8');
+        assert.ok(!/\bCLAUDE\.md\b/.test(content),
+          `${path.relative(targetDir, full)} still references CLAUDE.md`);
+        if (/\.hermes\.md/.test(content)) referencedHermesMd = true;
+      }
+    };
+    walk(skillsDir);
+    // Sanity: at least one skill in the GSD set references the project
+    // context filename, so the substitution actually exercises.
+    assert.ok(referencedHermesMd, 'at least one skill references .hermes.md after substitution');
+
+    uninstall(false, 'hermes');
+  });
 });
 
 describe('E2E: Hermes Agent uninstall skills cleanup', () => {