@olegkoval/agent-skills 1.55.3 → 1.56.0

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # agent-skills
 
 An agent-agnostic skill catalog published to Claude Code, Codex, Cursor, Grok,
-Copilot, Windsurf and Kiro.
+Copilot, Windsurf, Kiro and Hermes Agent.
 
 ## Hard rules
 

package/README.md

@@ -1,15 +1,15 @@
 <div align="center">
   <h1>agent skills</h1>
-  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.</strong></p>
+  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, Hermes Agent, and other skill-aware tools.</strong></p>
   <p>
     <img src="https://img.shields.io/badge/license-MIT-16a34a" alt="MIT license">
-    <img src="https://img.shields.io/badge/skills-53-2563eb" alt="53 skills">
-    <img src="https://img.shields.io/badge/platforms-Codex%20%7C%20Claude%20%7C%20Cursor%20%7C%20Grok%20%7C%20Copilot%20%7C%20Windsurf%20%7C%20Kiro-111827" alt="Codex Claude Cursor Grok Copilot Windsurf Kiro">
+    <img src="https://img.shields.io/badge/skills-55-2563eb" alt="55 skills">
+    <img src="https://img.shields.io/badge/platforms-Codex%20%7C%20Claude%20%7C%20Cursor%20%7C%20Grok%20%7C%20Copilot%20%7C%20Windsurf%20%7C%20Kiro%20%7C%20Hermes-111827" alt="Codex Claude Cursor Grok Copilot Windsurf Kiro Hermes">
     <img src="https://img.shields.io/badge/status-public%20catalog-16a34a" alt="Public catalog">
   </p>
 </div>
 
-Agent-agnostic skill collection for Codex, Claude, Cursor, Grok, and other skill-aware tools.
+Agent-agnostic skill collection for Codex, Claude, Cursor, Grok, Hermes Agent, and other skill-aware tools.
 
 **Browse the catalog: [skills.olegkoval.com](https://skills.olegkoval.com)**
 
@@ -124,6 +124,29 @@ Use the olko:semantic-release-beta skill to add prereleases on a beta branch.
 
 </details>
 
+<details>
+<summary><b>Hermes Agent</b></summary>
+
+Install the catalog into the active Hermes profile from a persistent checkout:
+
+```bash
+git clone https://github.com/oleg-koval/agent-skills.git
+cd agent-skills
+./scripts/install-hermes-symlinks.sh
+```
+
+The installer links all 55 canonical skill packages under
+`${HERMES_HOME:-$HOME/.hermes}/skills/olko-agent-skills/`. It leaves existing paths untouched and
+fails on a collision. It reports obsolete catalog-owned links without removing them; after
+reviewing those links, run `./scripts/install-hermes-symlinks.sh --prune` to remove them.
+Set `HERMES_HOME` to target another profile. Run the installer again after adding
+skills to an updated checkout, then start a new Hermes session or use `/reload-skills`.
+Use `/skills` to browse or `/wrap-up` to invoke a skill; a skill with a duplicate name can
+be selected by its `olko-agent-skills/<plugin>/<skill>` path.
+Individual skills may still require the tools, credentials, or services named in their instructions.
+
+</details>
+
 <details>
 <summary><b>Grok</b></summary>
 
@@ -477,7 +500,7 @@ layout, the first-run walkthrough, and the contract callers follow when writing
 | Grok | `adapters/grok/<plugin>/` | Per-plugin skill copies |
 | Codex | `adapters/codex/<plugin>/README.md` | Pointer to the canonical skills |
 | Pi | `adapters/pi/<plugin>/README.md` | Pointer to the canonical skills |
-| Hermes | `adapters/hermes/<plugin>/README.md` | Pointer to the canonical skills |
+| Hermes Agent | `adapters/hermes/<plugin>/README.md` | Pointer to the canonical skills |
 | GitHub Copilot | `.github/copilot-instructions.md` | Repository instructions |
 | GitHub Copilot | `.github/prompts/*.prompt.md` | Per-skill prompt files |
 | Windsurf | `.windsurf/rules/*.md` | Cascade rules |
@@ -485,10 +508,11 @@ layout, the first-run walkthrough, and the contract callers follow when writing
 
 Every file above is generated from `catalog/skills.json` by `./scripts/build-adapters.sh`.
 Never edit one by hand: CI regenerates and fails on any difference.
+The maintained `scripts/install-hermes-symlinks.sh` makes the Hermes pointers usable by its skills loader.
 
 Coverage is per skill, not uniform. Each skill's `adapters` array in `catalog/skills.json`
-decides which targets it ships to, so the file counts differ per target: Claude 49, Grok 47,
-Cursor 45, Copilot 45, Codex 42, Windsurf 35, Kiro 35, Pi 2, Hermes 2. A skill is absent from a
+decides which targets it ships to, so the file counts differ per target: Claude 55, Grok 53,
+Cursor 51, Copilot 51, Codex 49, Windsurf 40, Kiro 40, Pi 2, Hermes 55. A skill is absent from a
 target's tree when its catalog entry does not list that target.
 
 ## Local validation

package/adapters/hermes/olko-apple-kit/README.md

@@ -0,0 +1,9 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-apple-kit
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-apple-kit/skills/apple-store-submit/SKILL.md`
+- `plugins/olko-apple-kit/skills/macos-menubar-app/SKILL.md`

package/adapters/hermes/olko-creative/README.md

@@ -2,6 +2,11 @@
 
 # Hermes adapter: olko-creative
 
-Use the canonical skills directly:
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
 
+- `plugins/olko-creative/skills/gallery/SKILL.md`
+- `plugins/olko-creative/skills/fill-music-player/SKILL.md`
+- `plugins/olko-creative/skills/music-to-plex/SKILL.md`
+- `plugins/olko-creative/skills/vinted-listing/SKILL.md`
 - `plugins/olko-creative/skills/wikipedia-uk-editor/SKILL.md`

package/adapters/hermes/olko-garmin-kit/README.md

@@ -0,0 +1,8 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-garmin-kit
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-garmin-kit/skills/garmin-watchface/SKILL.md`

package/adapters/hermes/olko-git-tools/README.md

@@ -0,0 +1,10 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-git-tools
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-git-tools/skills/git-commit/SKILL.md`
+- `plugins/olko-git-tools/skills/gh-cli/SKILL.md`
+- `plugins/olko-git-tools/skills/branch-cleanup/SKILL.md`

package/adapters/hermes/olko-github-pr/README.md

@@ -0,0 +1,20 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-github-pr
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-github-pr/skills/pr-finalize/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-finalize-complete/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-to-green/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-description-writer/SKILL.md`
+- `plugins/olko-github-pr/skills/qodoloop/SKILL.md`
+- `plugins/olko-github-pr/skills/coderabbitloop/SKILL.md`
+- `plugins/olko-github-pr/skills/codexloop/SKILL.md`
+- `plugins/olko-github-pr/skills/copilotloop/SKILL.md`
+- `plugins/olko-github-pr/skills/geminiloop/SKILL.md`
+- `plugins/olko-github-pr/skills/ci-fix-loop/SKILL.md`
+- `plugins/olko-github-pr/skills/nas-actions-migration/SKILL.md`
+- `plugins/olko-github-pr/skills/dependabot-triage/SKILL.md`
+- `plugins/olko-github-pr/skills/lekker-review/SKILL.md`

package/adapters/hermes/olko-obsidian/README.md

@@ -0,0 +1,10 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-obsidian
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-obsidian/skills/obsidian-pr-sync/SKILL.md`
+- `plugins/olko-obsidian/skills/obsidian-task-rollover/SKILL.md`
+- `plugins/olko-obsidian/skills/morning-routine/SKILL.md`

package/adapters/hermes/olko-product/README.md

@@ -0,0 +1,12 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-product
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-product/skills/product-builder/SKILL.md`
+- `plugins/olko-product/skills/mvp-oneshot/SKILL.md`
+- `plugins/olko-product/skills/ux-ui-audit-loop/SKILL.md`
+- `plugins/olko-product/skills/starter-rules/SKILL.md`
+- `plugins/olko-product/skills/viral-launch/SKILL.md`

package/adapters/hermes/olko-reflection/README.md

@@ -0,0 +1,13 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-reflection
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-reflection/skills/self-critique/SKILL.md`
+- `plugins/olko-reflection/skills/review-past-performance/SKILL.md`
+- `plugins/olko-reflection/skills/retro-analysis/SKILL.md`
+- `plugins/olko-reflection/skills/agent-ops-retro/SKILL.md`
+- `plugins/olko-reflection/skills/crash-course/SKILL.md`
+- `plugins/olko-reflection/skills/wrap-up/SKILL.md`

package/adapters/hermes/olko-release/README.md

@@ -0,0 +1,12 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-release
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-release/skills/semantic-release-beta/SKILL.md`
+- `plugins/olko-release/skills/open-source-publisher/SKILL.md`
+- `plugins/olko-release/skills/release-day/SKILL.md`
+- `plugins/olko-release/skills/changelog-generator/SKILL.md`
+- `plugins/olko-release/skills/store-listing-copy/SKILL.md`

package/adapters/hermes/olko-skill-meta/README.md

@@ -0,0 +1,15 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Hermes adapter: olko-skill-meta
+
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
+
+- `plugins/olko-skill-meta/skills/context-repo/SKILL.md`
+- `plugins/olko-skill-meta/skills/add-to-my-skills/SKILL.md`
+- `plugins/olko-skill-meta/skills/skill-budget-audit/SKILL.md`
+- `plugins/olko-skill-meta/skills/promptctl/SKILL.md`
+- `plugins/olko-skill-meta/skills/veto-routing/SKILL.md`
+- `plugins/olko-skill-meta/skills/ai-tools-setup/SKILL.md`
+- `plugins/olko-skill-meta/skills/relay/SKILL.md`
+- `plugins/olko-skill-meta/skills/shared-knowledge-artifact/SKILL.md`

package/adapters/hermes/olko-web-ops/README.md

@@ -2,6 +2,10 @@
 
 # Hermes adapter: olko-web-ops
 
-Use the canonical skills directly:
+Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills
+into the active Hermes profile. The canonical packages are:
 
+- `plugins/olko-web-ops/skills/cloudflare-block-countries/SKILL.md`
 - `plugins/olko-web-ops/skills/search-console-indexing-audit/SKILL.md`
+- `plugins/olko-web-ops/skills/docs-index-keeper/SKILL.md`
+- `plugins/olko-web-ops/skills/website-analytics-bootstrap/SKILL.md`

package/catalog/skills.json

@@ -25,7 +25,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -48,7 +49,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -72,7 +74,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -93,7 +96,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -116,7 +120,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -139,7 +144,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -162,7 +168,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -185,7 +192,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -208,7 +216,8 @@
             "copilot",
             "grok",
             "windsurf",
-            "kiro"
+            "kiro",
+            "hermes"
           ]
         },
         {
@@ -229,7 +238,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -250,7 +260,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -272,7 +283,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -290,7 +302,8 @@
           ],
           "adapters": [
             "codex",
-            "claude"
+            "claude",
+            "hermes"
           ]
         }
       ]
@@ -316,7 +329,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -338,7 +352,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -359,7 +374,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -388,7 +404,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -413,7 +430,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -438,7 +456,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -459,7 +478,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -484,7 +504,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -512,7 +533,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -536,7 +558,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -560,7 +583,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -584,7 +608,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -607,7 +632,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -636,7 +662,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -658,7 +685,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -676,7 +704,8 @@
           ],
           "adapters": [
             "claude",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -697,7 +726,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -720,7 +750,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -742,7 +773,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -758,7 +790,8 @@
           ],
           "adapters": [
             "claude",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -775,7 +808,8 @@
             "documentation"
           ],
           "adapters": [
-            "claude"
+            "claude",
+            "hermes"
           ]
         }
       ]
@@ -802,7 +836,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -825,7 +860,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -849,7 +885,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -873,7 +910,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -896,7 +934,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -919,7 +958,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -955,7 +995,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -977,7 +1018,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1000,7 +1042,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -1030,7 +1073,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1054,7 +1098,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -1083,7 +1128,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]
@@ -1110,7 +1156,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1132,7 +1179,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1156,7 +1204,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1177,7 +1226,8 @@
             "claude",
             "cursor",
             "copilot",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1230,7 +1280,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1277,7 +1328,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         },
         {
@@ -1300,7 +1352,8 @@
             "copilot",
             "windsurf",
             "kiro",
-            "grok"
+            "grok",
+            "hermes"
           ]
         }
       ]

package/docs/skill-anatomy.md

@@ -145,7 +145,7 @@ Current adapter targets:
 | `windsurf` | n/a | `.windsurf/rules/{name}.md` |
 | `kiro` | n/a | `.kiro/steering/{name}.md` |
 
-Adapter coverage is not uniform across the catalog; a skill only ships the adapters listed in its `adapters` array in `catalog/skills.json`. As of this writing: claude 49, grok 47, cursor 45, copilot 45, codex 42, windsurf 35, kiro 35, pi 2, hermes 2 (out of 49 canonical skills).
+Adapter coverage is not uniform across the catalog; a skill only ships the adapters listed in its `adapters` array in `catalog/skills.json`. Current coverage: claude 55, grok 53, cursor 51, copilot 51, codex 49, windsurf 40, kiro 40, pi 2, hermes 55 (out of 55 canonical skills). Hermes uses `scripts/install-hermes-symlinks.sh` to expose the canonical packages to its skills loader.
 
 Claude plugin and marketplace identifiers must be kebab-case. Keep `olko:*` names for Codex and Cursor lookup names, but do not use colons or spaces in Claude marketplace/plugin names.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/plugins/olko-apple-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-apple-kit",
   "description": "Build and ship Apple platform apps: macOS menubar apps, App Store submissions.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-creative/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-creative",
   "description": "Creative and personal projects: photo galleries, music players, listings, wiki editing.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-garmin-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-garmin-kit",
   "description": "Build, test and publish Garmin Connect IQ watch faces.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-git-tools/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-git-tools",
   "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-github-pr/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-github-pr",
   "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-obsidian/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-obsidian",
   "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-product/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-product",
   "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, UX/UI quality loops, launch plans.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-reflection/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-reflection",
   "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-release/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-release",
   "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-skill-meta/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-skill-meta",
   "description": "Author and maintain agent skills and the AI toolchain itself.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-web-ops/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-web-ops",
   "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes.",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "author": {
     "name": "Oleg Koval"
   },

package/scripts/build-adapters.sh

@@ -135,7 +135,10 @@ for (const skill of catalog.skills) {
     mkdirSync(dir, { recursive: true })
     writeFileSync(join(dir, 'README.md'), [
       generatedHeader, '', `# ${label} adapter: ${skill.plugin.name}`, '',
-      'Use the canonical skills directly:', '',
+      ...(target === 'hermes'
+        ? ['Run `./scripts/install-hermes-symlinks.sh` from the repository root to link these skills',
+           'into the active Hermes profile. The canonical packages are:', '']
+        : ['Use the canonical skills directly:', '']),
       ...skill.plugin.skills.filter((s) => s.adapters.includes(target))
         .map((s) => `- \`${s.path}/SKILL.md\``),
       '',

package/scripts/install-hermes-symlinks.sh

@@ -0,0 +1,118 @@
+#!/bin/sh
+set -eu
+
+HERMES_SKILLS_DIR="${HERMES_HOME:-$HOME/.hermes}/skills"
+case "$HERMES_SKILLS_DIR" in
+  /*) ;;
+  *) HERMES_SKILLS_DIR="$PWD/$HERMES_SKILLS_DIR" ;;
+esac
+case "${1:-}" in
+  "") HERMES_PRUNE=0 ;;
+  --prune) HERMES_PRUNE=1 ;;
+  *) echo "usage: $0 [--prune]" >&2; exit 2 ;;
+esac
+test "$#" -le 1 || { echo "usage: $0 [--prune]" >&2; exit 2; }
+# shellcheck disable=SC1007 # CDPATH= intentionally clears CDPATH before cd.
+ROOT="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
+
+cd "$ROOT"
+HERMES_SKILLS_DIR="$HERMES_SKILLS_DIR" HERMES_PRUNE="$HERMES_PRUNE" node --input-type=module <<'EOF'
+import { lstatSync, mkdirSync, readdirSync, readlinkSync, symlinkSync, unlinkSync } from 'node:fs'
+import { basename, dirname, join, relative, resolve, sep } from 'node:path'
+import { loadCatalog } from './scripts/lib/catalog.mjs'
+
+const root = process.cwd()
+const destination = join(process.env.HERMES_SKILLS_DIR, 'olko-agent-skills')
+const entries = loadCatalog().skills
+  .filter(skill => skill.adapters.includes('hermes'))
+  .map(skill => ({
+    target: join(root, skill.path),
+    link: join(destination, skill.plugin.name, skill.name),
+  }))
+
+const existing = path => {
+  try { return lstatSync(path) }
+  catch (error) {
+    if (error.code === 'ENOENT') return null
+    throw error
+  }
+}
+const isExpectedLink = (link, target) => {
+  const stat = existing(link)
+  return stat?.isSymbolicLink() && resolve(dirname(link), readlinkSync(link)) === target
+}
+const isManagedLink = link => {
+  if (!existing(link)?.isSymbolicLink()) return false
+  const target = resolve(dirname(link), readlinkSync(link))
+  const parts = relative(root, target).split(sep)
+  return parts.length === 4 && parts[0] === 'plugins' && parts[2] === 'skills'
+    && parts[1] === basename(dirname(link)) && parts[3] === basename(link)
+}
+
+// Inspect every destination before writing anything. Never replace user-owned paths.
+for (const parent of [destination, ...new Set(entries.map(entry => dirname(entry.link)))]) {
+  const stat = existing(parent)
+  if (stat && (!stat.isDirectory() || stat.isSymbolicLink())) {
+    throw new Error(`refusing to use non-directory or symlinked parent: ${parent}`)
+  }
+}
+for (const { target, link } of entries) {
+  const stat = existing(link)
+  if (stat && !isExpectedLink(link, target)) {
+    throw new Error(`refusing to replace existing skill path: ${link}`)
+  }
+}
+
+const wanted = new Set(entries.map(entry => entry.link))
+const stale = []
+if (existing(destination)) {
+  for (const plugin of readdirSync(destination, { withFileTypes: true })) {
+    if (!plugin.isDirectory()) continue
+    const pluginDir = join(destination, plugin.name)
+    for (const skill of readdirSync(pluginDir)) {
+      const link = join(pluginDir, skill)
+      if (!wanted.has(link) && isManagedLink(link)) stale.push(link)
+    }
+  }
+}
+if (stale.length && process.env.HERMES_PRUNE !== '1') {
+  throw new Error(`${stale.length} stale catalog-owned link(s) found; inspect them and rerun with --prune to remove them`)
+}
+
+let linked = 0
+const created = []
+try {
+  for (const { target, link } of entries) {
+    if (existing(link)) {
+      if (!isExpectedLink(link, target)) throw new Error(`refusing to replace existing skill path: ${link}`)
+      continue
+    }
+    mkdirSync(dirname(link), { recursive: true })
+    try {
+      symlinkSync(target, link, 'dir')
+    } catch (error) {
+      if (error.code === 'EEXIST' && isExpectedLink(link, target)) continue
+      throw error
+    }
+    const stat = lstatSync(link)
+    created.push({ link, target, dev: stat.dev, ino: stat.ino })
+    linked++
+  }
+} catch (error) {
+  for (const { link, target, dev, ino } of created.reverse()) {
+    const stat = existing(link)
+    if (stat?.dev === dev && stat?.ino === ino && isExpectedLink(link, target)) unlinkSync(link)
+  }
+  throw error
+}
+let pruned = 0
+if (process.env.HERMES_PRUNE === '1') {
+  for (const link of stale) {
+    if (isManagedLink(link)) {
+      unlinkSync(link)
+      pruned++
+    }
+  }
+}
+console.log(`Hermes skills: ${entries.length} available, ${linked} linked, ${entries.length - linked} already linked, ${pruned} pruned`)
+EOF