@olegkoval/agent-skills 1.35.0 → 1.35.1

package/README.md

@@ -22,6 +22,7 @@ These skills are opinionated by design. They encode working defaults, preferred
 - `adapters/`: generated per-tool wrappers (Claude, Codex, Cursor, Grok, Pi, Hermes)
 - `scripts/`: sync, build, and validation helpers
 - `site/`: generator for the browsable catalog at [skills.olegkoval.com](https://skills.olegkoval.com) (`npm run build:site`)
+- `docs/versioning.md`: catalog/plugin versioning and release automation contract
 
 ## Principles
 

package/docs/versioning.md

@@ -0,0 +1,25 @@
+# Versioning
+
+This repository versions the installable catalog release, not each individual
+skill. A skill is a canonical `SKILL.md` plus its resources; it is not an
+independently published package. The catalog is split into installable plugins,
+and every plugin in a release shares the catalog version.
+
+The version source is `package.json`. Conventional commits on `main` and
+`beta` are evaluated by semantic-release, which updates the package version,
+changelog, Git tag, GitHub release, and npm publication. The generated Claude
+plugin manifests receive that same version during semantic-release's `prepare`
+phase, after the npm plugin calculates the next version and before the release
+commit is created.
+
+Do not add a version to an individual skill unless that skill becomes an
+independently distributed package with its own compatibility and release
+lifecycle.
+
+To verify the generated state locally:
+
+```bash
+npm run build
+git diff --exit-code
+npm test
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.35.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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, launch plans.",
-  "version": "1.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "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.34.0",
+  "version": "1.35.1",
   "author": {
     "name": "Oleg Koval"
   },

package/scripts/semantic-release-build.cjs

@@ -0,0 +1,7 @@
+const { execFileSync } = require('node:child_process')
+
+module.exports = {
+  prepare() {
+    execFileSync('npm', ['run', 'build'], { stdio: 'inherit' })
+  },
+}

package/scripts/validate-catalog.sh

@@ -30,6 +30,7 @@ const adapterFile = {
 }
 
 const catalog = loadCatalog()
+const packageJson = JSON.parse(readFileSync('package.json', 'utf8'))
 
 // Plugin-level invariants.
 const pluginNames = new Set()
@@ -44,6 +45,13 @@ for (const plugin of catalog.plugins) {
   }
   const manifest = join('plugins', plugin.name, '.claude-plugin', 'plugin.json')
   if (!existsSync(manifest)) throw new Error(`missing generated plugin manifest: ${manifest}`)
+  const manifestVersion = JSON.parse(readFileSync(manifest, 'utf8')).version
+  if (manifestVersion !== packageJson.version) {
+    throw new Error(
+      `plugin manifest version drift for ${plugin.name}: ` +
+      `expected ${packageJson.version}, got ${manifestVersion}`
+    )
+  }
 }
 
 // Skill-level invariants, including the duplicate-name check.