@olegkoval/agent-skills 1.42.1 → 1.42.2

package/adapters/cursor/olko-product/skills/viral-launch/SKILL.md

@@ -1,7 +1,11 @@
 ---
-
 name: viral-launch
-description: Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops without pretending virality is guaranteed.
+description: >
+  Prepare a project for a public launch: shareable positioning, a launch-readiness pass over the
+  repository, and the growth loops worth building, without pretending virality is guaranteed. Use
+  when the user says "help me launch this", "prep for Product Hunt", "write the launch post", "make
+  this shareable", "launch plan", or is about to make a repo or product public. For building the
+  thing itself use mvp-oneshot or product-builder.
 license: MIT
 allowed-tools: Bash, Read, Write, WebSearch, WebFetch
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.

package/adapters/cursor/olko-reflection/skills/retro-analysis/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: retro-analysis
-description: Produce a recurring engineering retrospective from repository history, delivery evidence, work patterns, code-quality signals, and prior snapshots, with repository, comparison, and cross-project modes.
+description: >
+  Produce a recurring engineering retrospective from repository history, delivery evidence, work
+  patterns, code-quality signals and prior snapshots, in repository, comparison or cross-project
+  mode. Use when the user asks for a retro over shipped work: "run a retrospective", "how did this
+  quarter go", "compare this month to last", "what did we ship", "engineering retro across my
+  repos", or when a scheduled retro job fires. This is the repository axis: for how the agents
+  themselves are being operated use agent-ops-retro, for a single finished change use wrap-up.
 license: MIT
 metadata:
   author: Oleg Koval

package/adapters/cursor/olko-reflection/skills/wrap-up/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: wrap-up
-description: Verify that a completed implementation matches its original objective, all applicable checks are green, and task-owned temporary files, worktrees, and local branches are safely tidied.
+description: >
+  Close out a finished piece of work: verify the implementation actually matches its original
+  objective, confirm every applicable check is green, and safely tidy the temporary files,
+  worktrees and local branches the task created. Use when a change is believed done and the user
+  says "wrap up", "we are done here", "finish up", "clean up after this", "tidy the worktrees", or
+  before handing work off. This is the single-change axis: for a retro over repository history use
+  retro-analysis, for how the agents are being operated use agent-ops-retro.
 license: MIT
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Grok, and other Agent Skills compatible tools.
 metadata:

package/adapters/cursor/olko-release/skills/changelog-generator/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: changelog-generator
-description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+description: >
+  Turn git commit history into a user-facing changelog: read the commits since the last release,
+  categorise them, and rewrite technical messages as release notes a customer can actually read.
+  Use when the user asks for "a changelog", "release notes", "what changed since the last release",
+  "write the CHANGELOG entry", or is preparing a release and needs the notes written. For setting
+  up the release pipeline itself use semantic-release-beta.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git history access in the target repository.

package/adapters/cursor/olko-release/skills/semantic-release-beta/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: semantic-release-beta
-description: Set up or update a Node.js release pipeline that uses semantic-release-npm-github-publish with a stable main channel and a prerelease beta channel on a beta branch, including GitHub Actions validation and npm publishing behavior.
+description: >
+  Set up or repair a Node.js release pipeline built on semantic-release-npm-github-publish, with a
+  stable channel on main and a prerelease channel on a beta branch, including the GitHub Actions
+  validation and npm publishing behaviour. Use when the user wants "semantic release set up", "a
+  beta release channel", "prerelease publishing", "automated npm publishing", or when an npm
+  package's releases are still manual and should become commit-driven. For writing the notes of a
+  single release use changelog-generator.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a Node.js package repository that uses git and GitHub Actions.

package/adapters/cursor/olko-skill-meta/skills/ai-tools-setup/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: ai-tools-setup
-description: 'Set up, repair, and report on the RTK+ICM+Vox AI development toolkit. Installs missing tools, fixes broken hooks and MCP config, and shows an effectiveness digest (token savings, memory accumulation, voice health) on demand or as a scheduled weekly report.'
+description: >
+  Set up, repair, and report on the RTK+ICM+Vox AI development toolkit: installs missing tools,
+  fixes broken hooks and MCP config, and shows an effectiveness digest covering token savings,
+  memory accumulation and voice health. Use when the user says "set up my AI tools", "my hooks are
+  broken", "MCP is not loading", "check my toolkit", "is ICM working", "how much are these tools
+  saving me", or when the scheduled weekly toolkit report fires.
 license: MIT
 allowed-tools: Bash, Read, Edit, Write
 compatibility: Claude Code on macOS (Homebrew required)

package/adapters/cursor/olko-skill-meta/skills/promptctl/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: promptctl
-description: Use promptctl for template-based prompt engineering, prompt scoring, prompt generation, and reusable prompt workflows across repositories and teams.
+description: >
+  Manage reusable prompts with the promptctl CLI: template-based prompt engineering, prompt
+  generation, and scoring a prompt before it ships. Use when the user wants to "write a reusable
+  prompt", "score this prompt", "turn this into a prompt template", "share prompts across repos",
+  or names promptctl directly. For bringing an agent skill into this catalog use
+  add-to-my-skills.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires promptctl to be installed when the workflow depends on the CLI.

package/adapters/cursor/olko-web-ops/skills/docs-index-keeper/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: docs-index-keeper
-description: Keep a repository's Markdown docs index in sync by installing and running docs-index-keeper in pre-commit hooks, CI, or one-off maintenance flows.
+description: >
+  Keep a repository's Markdown docs index in sync with the files that actually exist, by installing
+  and running docs-index-keeper in a pre-commit hook, in CI, or as a one-off sweep. Use when the
+  user says "the docs index is stale", "update the docs index", "add a docs index check to CI",
+  "our doc links are out of date", or when new docs were added without being linked anywhere.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit, Grep, Glob
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires shell access and Node.js 18+ when installing from npm.

package/adapters/cursor/olko-web-ops/skills/website-analytics-bootstrap/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: website-analytics-bootstrap
-description: Set up a website's first SEO analytics loop end-to-end: persistent SerpBear rank tracking, Google Search Console, seeded keywords, read-only technical audits, and Telegram alerts on a local host or NAS.
+description: >
+  Stand up a website's first SEO analytics loop end to end: persistent SerpBear rank tracking,
+  Google Search Console, seeded keywords, read-only technical audits and Telegram alerts on a local
+  host or NAS. Use when the user says "set up rank tracking", "this site has no analytics", "track
+  my keywords", "bootstrap SEO monitoring", or wants to know how a site performs in search when no
+  tracking exists yet. For diagnosing an existing indexing problem use
+  search-console-indexing-audit.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires network access, a reachable deployment host, and owner-provided Search Console and alert credentials.

package/adapters/grok/olko-creative/skills/vinted-listing/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: vinted-listing
-description: Create, edit, and safely publish Vinted listings through the signed-in browser, using verified item details and the owner’s original photos.
+description: >
+  Create, edit, and safely publish a Vinted listing through the signed-in browser, using verified
+  item details and the owner's original photos. Suggests title, description, category, brand,
+  condition, colour and parcel size from the photos, saves a draft first, and requires explicit
+  confirmation before publishing. Use when the user wants to list, sell, relist or price an item on
+  Vinted, or says "put this on Vinted", "create a Vinted listing", "sell this on Vinted", "edit my
+  Vinted draft", or "publish that listing". Browser workflow, not an API integration.
 ---
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 

package/adapters/grok/olko-git-tools/skills/gh-cli/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: gh-cli
-description: GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
+description: >
+  Reach for the GitHub CLI (gh) to do something on GitHub from the command line: repositories,
+  issues, pull requests, Actions runs and logs, projects, releases, gists, codespaces, org and
+  extension management. Use when a task needs a gh command and the exact syntax, flag or API path
+  is not obvious, or the user says "use gh", "what is the gh command for", "list my PRs from the
+  CLI", or "query the GitHub API". For driving a PR through review bots and CI use the
+  olko-github-pr skills instead; this one is the command reference.
 license: MIT
 allowed-tools: Bash
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires the GitHub CLI and valid GitHub authentication.

package/adapters/grok/olko-product/skills/viral-launch/SKILL.md

@@ -1,7 +1,11 @@
 ---
-
 name: viral-launch
-description: Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops without pretending virality is guaranteed.
+description: >
+  Prepare a project for a public launch: shareable positioning, a launch-readiness pass over the
+  repository, and the growth loops worth building, without pretending virality is guaranteed. Use
+  when the user says "help me launch this", "prep for Product Hunt", "write the launch post", "make
+  this shareable", "launch plan", or is about to make a repo or product public. For building the
+  thing itself use mvp-oneshot or product-builder.
 license: MIT
 allowed-tools: Bash, Read, Write, WebSearch, WebFetch
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.

package/adapters/grok/olko-reflection/skills/retro-analysis/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: retro-analysis
-description: Produce a recurring engineering retrospective from repository history, delivery evidence, work patterns, code-quality signals, and prior snapshots, with repository, comparison, and cross-project modes.
+description: >
+  Produce a recurring engineering retrospective from repository history, delivery evidence, work
+  patterns, code-quality signals and prior snapshots, in repository, comparison or cross-project
+  mode. Use when the user asks for a retro over shipped work: "run a retrospective", "how did this
+  quarter go", "compare this month to last", "what did we ship", "engineering retro across my
+  repos", or when a scheduled retro job fires. This is the repository axis: for how the agents
+  themselves are being operated use agent-ops-retro, for a single finished change use wrap-up.
 license: MIT
 metadata:
   author: Oleg Koval

package/adapters/grok/olko-reflection/skills/wrap-up/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: wrap-up
-description: Verify that a completed implementation matches its original objective, all applicable checks are green, and task-owned temporary files, worktrees, and local branches are safely tidied.
+description: >
+  Close out a finished piece of work: verify the implementation actually matches its original
+  objective, confirm every applicable check is green, and safely tidy the temporary files,
+  worktrees and local branches the task created. Use when a change is believed done and the user
+  says "wrap up", "we are done here", "finish up", "clean up after this", "tidy the worktrees", or
+  before handing work off. This is the single-change axis: for a retro over repository history use
+  retro-analysis, for how the agents are being operated use agent-ops-retro.
 license: MIT
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Grok, and other Agent Skills compatible tools.
 metadata:

package/adapters/grok/olko-release/skills/changelog-generator/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: changelog-generator
-description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+description: >
+  Turn git commit history into a user-facing changelog: read the commits since the last release,
+  categorise them, and rewrite technical messages as release notes a customer can actually read.
+  Use when the user asks for "a changelog", "release notes", "what changed since the last release",
+  "write the CHANGELOG entry", or is preparing a release and needs the notes written. For setting
+  up the release pipeline itself use semantic-release-beta.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git history access in the target repository.

package/adapters/grok/olko-release/skills/semantic-release-beta/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: semantic-release-beta
-description: Set up or update a Node.js release pipeline that uses semantic-release-npm-github-publish with a stable main channel and a prerelease beta channel on a beta branch, including GitHub Actions validation and npm publishing behavior.
+description: >
+  Set up or repair a Node.js release pipeline built on semantic-release-npm-github-publish, with a
+  stable channel on main and a prerelease channel on a beta branch, including the GitHub Actions
+  validation and npm publishing behaviour. Use when the user wants "semantic release set up", "a
+  beta release channel", "prerelease publishing", "automated npm publishing", or when an npm
+  package's releases are still manual and should become commit-driven. For writing the notes of a
+  single release use changelog-generator.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a Node.js package repository that uses git and GitHub Actions.

package/adapters/grok/olko-skill-meta/skills/ai-tools-setup/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: ai-tools-setup
-description: 'Set up, repair, and report on the RTK+ICM+Vox AI development toolkit. Installs missing tools, fixes broken hooks and MCP config, and shows an effectiveness digest (token savings, memory accumulation, voice health) on demand or as a scheduled weekly report.'
+description: >
+  Set up, repair, and report on the RTK+ICM+Vox AI development toolkit: installs missing tools,
+  fixes broken hooks and MCP config, and shows an effectiveness digest covering token savings,
+  memory accumulation and voice health. Use when the user says "set up my AI tools", "my hooks are
+  broken", "MCP is not loading", "check my toolkit", "is ICM working", "how much are these tools
+  saving me", or when the scheduled weekly toolkit report fires.
 license: MIT
 allowed-tools: Bash, Read, Edit, Write
 compatibility: Claude Code on macOS (Homebrew required)

package/adapters/grok/olko-skill-meta/skills/promptctl/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: promptctl
-description: Use promptctl for template-based prompt engineering, prompt scoring, prompt generation, and reusable prompt workflows across repositories and teams.
+description: >
+  Manage reusable prompts with the promptctl CLI: template-based prompt engineering, prompt
+  generation, and scoring a prompt before it ships. Use when the user wants to "write a reusable
+  prompt", "score this prompt", "turn this into a prompt template", "share prompts across repos",
+  or names promptctl directly. For bringing an agent skill into this catalog use
+  add-to-my-skills.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires promptctl to be installed when the workflow depends on the CLI.

package/adapters/grok/olko-web-ops/skills/docs-index-keeper/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: docs-index-keeper
-description: Keep a repository's Markdown docs index in sync by installing and running docs-index-keeper in pre-commit hooks, CI, or one-off maintenance flows.
+description: >
+  Keep a repository's Markdown docs index in sync with the files that actually exist, by installing
+  and running docs-index-keeper in a pre-commit hook, in CI, or as a one-off sweep. Use when the
+  user says "the docs index is stale", "update the docs index", "add a docs index check to CI",
+  "our doc links are out of date", or when new docs were added without being linked anywhere.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit, Grep, Glob
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires shell access and Node.js 18+ when installing from npm.

package/adapters/grok/olko-web-ops/skills/website-analytics-bootstrap/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: website-analytics-bootstrap
-description: Set up a website's first SEO analytics loop end-to-end: persistent SerpBear rank tracking, Google Search Console, seeded keywords, read-only technical audits, and Telegram alerts on a local host or NAS.
+description: >
+  Stand up a website's first SEO analytics loop end to end: persistent SerpBear rank tracking,
+  Google Search Console, seeded keywords, read-only technical audits and Telegram alerts on a local
+  host or NAS. Use when the user says "set up rank tracking", "this site has no analytics", "track
+  my keywords", "bootstrap SEO monitoring", or wants to know how a site performs in search when no
+  tracking exists yet. For diagnosing an existing indexing problem use
+  search-console-indexing-audit.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires network access, a reachable deployment host, and owner-provided Search Console and alert credentials.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.42.1",
+  "version": "1.42.2",
   "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.42.1",
+  "version": "1.42.2",
   "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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-creative/skills/vinted-listing/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: vinted-listing
-description: Create, edit, and safely publish Vinted listings through the signed-in browser, using verified item details and the owner’s original photos.
+description: >
+  Create, edit, and safely publish a Vinted listing through the signed-in browser, using verified
+  item details and the owner's original photos. Suggests title, description, category, brand,
+  condition, colour and parcel size from the photos, saves a draft first, and requires explicit
+  confirmation before publishing. Use when the user wants to list, sell, relist or price an item on
+  Vinted, or says "put this on Vinted", "create a Vinted listing", "sell this on Vinted", "edit my
+  Vinted draft", or "publish that listing". Browser workflow, not an API integration.
 ---
 
 # Vinted Listing

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.42.1",
+  "version": "1.42.2",
   "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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-git-tools/skills/gh-cli/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: gh-cli
-description: GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
+description: >
+  Reach for the GitHub CLI (gh) to do something on GitHub from the command line: repositories,
+  issues, pull requests, Actions runs and logs, projects, releases, gists, codespaces, org and
+  extension management. Use when a task needs a gh command and the exact syntax, flag or API path
+  is not obvious, or the user says "use gh", "what is the gh command for", "list my PRs from the
+  CLI", or "query the GitHub API". For driving a PR through review bots and CI use the
+  olko-github-pr skills instead; this one is the command reference.
 license: MIT
 allowed-tools: Bash
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires the GitHub CLI and valid GitHub authentication.

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.42.1",
+  "version": "1.42.2",
   "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.42.1",
+  "version": "1.42.2",
   "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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-product/skills/viral-launch/SKILL.md

@@ -1,7 +1,11 @@
 ---
-
 name: viral-launch
-description: Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops without pretending virality is guaranteed.
+description: >
+  Prepare a project for a public launch: shareable positioning, a launch-readiness pass over the
+  repository, and the growth loops worth building, without pretending virality is guaranteed. Use
+  when the user says "help me launch this", "prep for Product Hunt", "write the launch post", "make
+  this shareable", "launch plan", or is about to make a repo or product public. For building the
+  thing itself use mvp-oneshot or product-builder.
 license: MIT
 allowed-tools: Bash, Read, Write, WebSearch, WebFetch
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.

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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-reflection/skills/retro-analysis/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: retro-analysis
-description: Produce a recurring engineering retrospective from repository history, delivery evidence, work patterns, code-quality signals, and prior snapshots, with repository, comparison, and cross-project modes.
+description: >
+  Produce a recurring engineering retrospective from repository history, delivery evidence, work
+  patterns, code-quality signals and prior snapshots, in repository, comparison or cross-project
+  mode. Use when the user asks for a retro over shipped work: "run a retrospective", "how did this
+  quarter go", "compare this month to last", "what did we ship", "engineering retro across my
+  repos", or when a scheduled retro job fires. This is the repository axis: for how the agents
+  themselves are being operated use agent-ops-retro, for a single finished change use wrap-up.
 license: MIT
 metadata:
   author: Oleg Koval

package/plugins/olko-reflection/skills/wrap-up/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: wrap-up
-description: Verify that a completed implementation matches its original objective, all applicable checks are green, and task-owned temporary files, worktrees, and local branches are safely tidied.
+description: >
+  Close out a finished piece of work: verify the implementation actually matches its original
+  objective, confirm every applicable check is green, and safely tidy the temporary files,
+  worktrees and local branches the task created. Use when a change is believed done and the user
+  says "wrap up", "we are done here", "finish up", "clean up after this", "tidy the worktrees", or
+  before handing work off. This is the single-change axis: for a retro over repository history use
+  retro-analysis, for how the agents are being operated use agent-ops-retro.
 license: MIT
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Grok, and other Agent Skills compatible tools.
 metadata:

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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-release/skills/changelog-generator/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: changelog-generator
-description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+description: >
+  Turn git commit history into a user-facing changelog: read the commits since the last release,
+  categorise them, and rewrite technical messages as release notes a customer can actually read.
+  Use when the user asks for "a changelog", "release notes", "what changed since the last release",
+  "write the CHANGELOG entry", or is preparing a release and needs the notes written. For setting
+  up the release pipeline itself use semantic-release-beta.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git history access in the target repository.

package/plugins/olko-release/skills/semantic-release-beta/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: semantic-release-beta
-description: Set up or update a Node.js release pipeline that uses semantic-release-npm-github-publish with a stable main channel and a prerelease beta channel on a beta branch, including GitHub Actions validation and npm publishing behavior.
+description: >
+  Set up or repair a Node.js release pipeline built on semantic-release-npm-github-publish, with a
+  stable channel on main and a prerelease channel on a beta branch, including the GitHub Actions
+  validation and npm publishing behaviour. Use when the user wants "semantic release set up", "a
+  beta release channel", "prerelease publishing", "automated npm publishing", or when an npm
+  package's releases are still manual and should become commit-driven. For writing the notes of a
+  single release use changelog-generator.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a Node.js package repository that uses git and GitHub Actions.

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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-skill-meta/skills/ai-tools-setup/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: ai-tools-setup
-description: 'Set up, repair, and report on the RTK+ICM+Vox AI development toolkit. Installs missing tools, fixes broken hooks and MCP config, and shows an effectiveness digest (token savings, memory accumulation, voice health) on demand or as a scheduled weekly report.'
+description: >
+  Set up, repair, and report on the RTK+ICM+Vox AI development toolkit: installs missing tools,
+  fixes broken hooks and MCP config, and shows an effectiveness digest covering token savings,
+  memory accumulation and voice health. Use when the user says "set up my AI tools", "my hooks are
+  broken", "MCP is not loading", "check my toolkit", "is ICM working", "how much are these tools
+  saving me", or when the scheduled weekly toolkit report fires.
 license: MIT
 allowed-tools: Bash, Read, Edit, Write
 compatibility: Claude Code on macOS (Homebrew required)

package/plugins/olko-skill-meta/skills/promptctl/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: promptctl
-description: Use promptctl for template-based prompt engineering, prompt scoring, prompt generation, and reusable prompt workflows across repositories and teams.
+description: >
+  Manage reusable prompts with the promptctl CLI: template-based prompt engineering, prompt
+  generation, and scoring a prompt before it ships. Use when the user wants to "write a reusable
+  prompt", "score this prompt", "turn this into a prompt template", "share prompts across repos",
+  or names promptctl directly. For bringing an agent skill into this catalog use
+  add-to-my-skills.
 license: MIT
 allowed-tools: Bash, Read, Write
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires promptctl to be installed when the workflow depends on the CLI.

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.42.1",
+  "version": "1.42.2",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-web-ops/skills/docs-index-keeper/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: docs-index-keeper
-description: Keep a repository's Markdown docs index in sync by installing and running docs-index-keeper in pre-commit hooks, CI, or one-off maintenance flows.
+description: >
+  Keep a repository's Markdown docs index in sync with the files that actually exist, by installing
+  and running docs-index-keeper in a pre-commit hook, in CI, or as a one-off sweep. Use when the
+  user says "the docs index is stale", "update the docs index", "add a docs index check to CI",
+  "our doc links are out of date", or when new docs were added without being linked anywhere.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit, Grep, Glob
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires shell access and Node.js 18+ when installing from npm.

package/plugins/olko-web-ops/skills/website-analytics-bootstrap/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: website-analytics-bootstrap
-description: Set up a website's first SEO analytics loop end-to-end: persistent SerpBear rank tracking, Google Search Console, seeded keywords, read-only technical audits, and Telegram alerts on a local host or NAS.
+description: >
+  Stand up a website's first SEO analytics loop end to end: persistent SerpBear rank tracking,
+  Google Search Console, seeded keywords, read-only technical audits and Telegram alerts on a local
+  host or NAS. Use when the user says "set up rank tracking", "this site has no analytics", "track
+  my keywords", "bootstrap SEO monitoring", or wants to know how a site performs in search when no
+  tracking exists yet. For diagnosing an existing indexing problem use
+  search-console-indexing-audit.
 license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires network access, a reachable deployment host, and owner-provided Search Console and alert credentials.