@olegkoval/agent-skills 1.21.0 → 1.21.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-agent-skills",
   "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "author": {
     "name": "Oleg Koval"
   },
@@ -34,6 +34,9 @@
     "./packages/software-development/crash-course",
     "./packages/software-development/qodoloop",
     "./packages/wearables/garmin-watchface",
-    "./packages/software-development/coderabbitloop"
+    "./packages/software-development/coderabbitloop",
+    "./packages/software-development/add-to-my-skills",
+    "./packages/software-development/ai-tools-setup",
+    "./packages/software-development/changelog-generator"
   ]
 }

package/.cursor-plugin/index.json

@@ -120,6 +120,21 @@
       "name": "olko:coderabbitloop",
       "source": "./packages/software-development/coderabbitloop/adapters/cursor",
       "description": "Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings — reads each inline comment's own Prompt for AI Agents block, applies the fix, replies to the thread, resolves it, pushes, and re-triggers CodeRabbit."
+    },
+    {
+      "name": "olko:add-to-my-skills",
+      "source": "./packages/software-development/add-to-my-skills/adapters/cursor",
+      "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
+    },
+    {
+      "name": "olko:ai-tools-setup",
+      "source": "./packages/software-development/ai-tools-setup/adapters/cursor",
+      "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
+    },
+    {
+      "name": "olko:changelog-generator",
+      "source": "./packages/software-development/changelog-generator/adapters/cursor",
+      "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
     }
   ]
 }

package/.grok-plugin/index.json

@@ -130,6 +130,21 @@
       "name": "olko:coderabbitloop",
       "source": "./packages/software-development/coderabbitloop/adapters/grok",
       "description": "Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings — reads each inline comment's own Prompt for AI Agents block, applies the fix, replies to the thread, resolves it, pushes, and re-triggers CodeRabbit."
+    },
+    {
+      "name": "olko:add-to-my-skills",
+      "source": "./packages/software-development/add-to-my-skills/adapters/grok",
+      "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
+    },
+    {
+      "name": "olko:ai-tools-setup",
+      "source": "./packages/software-development/ai-tools-setup/adapters/grok",
+      "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
+    },
+    {
+      "name": "olko:changelog-generator",
+      "source": "./packages/software-development/changelog-generator/adapters/grok",
+      "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
     }
   ]
 }

package/.kiro/steering/add-to-my-skills.md

@@ -2,10 +2,9 @@
 
 ---
 inclusion: manual
-description: "Copy a newly created skill into this catalog, refresh manifests, and publish the change."
+description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
 ---
 
-
 # Add to My Skills
 
 Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.

package/.kiro/steering/ai-tools-setup.md

@@ -2,10 +2,9 @@
 
 ---
 inclusion: manual
-description: "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health."
+description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
 ---
 
-
 # AI Tools Setup — RTK + ICM + Vox
 
 Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.

package/.kiro/steering/changelog-generator.md

@@ -2,10 +2,9 @@
 
 ---
 inclusion: manual
-description: "Generate user-facing changelogs and release notes from git history."
+description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
 ---
 
-
 # Changelog Generator
 
 This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.

package/.windsurf/rules/add-to-my-skills.md

@@ -1,10 +1,9 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Copy a newly created skill into this catalog, refresh manifests, and publish the change."
+description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
 ---
 
-
 # Add to My Skills
 
 Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.

package/.windsurf/rules/ai-tools-setup.md

@@ -1,10 +1,9 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health."
+description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
 ---
 
-
 # AI Tools Setup — RTK + ICM + Vox
 
 Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.

package/.windsurf/rules/changelog-generator.md

@@ -1,10 +1,9 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Generate user-facing changelogs and release notes from git history."
+description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
 ---
 
-
 # Changelog Generator
 
 This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.

package/README.md

@@ -136,11 +136,11 @@ packages/{category}/{skill}/SKILL.md
 
 </details>
 
-## All 26 Skills
+## All 29 Skills
 
 Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup name in a new agent session.
 
-### Software development (21)
+### Software development (24)
 
 | Skill | What it does | Use when |
 |-------|-------------|----------|
@@ -162,7 +162,9 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
 | [product-builder](packages/software-development/product-builder/SKILL.md) | Builds a full-stack web app or SaaS product from a user description using production-oriented defaults | Building a complete app, SaaS, dashboard, or product rather than a prototype |
 | [promptctl](packages/software-development/promptctl/SKILL.md) | Uses `promptctl` for reusable prompt templates, scoring, and workflow automation | A project needs prompt conventions, review, scoring, or reusable prompt workflows |
 | [qodoloop](packages/software-development/qodoloop/SKILL.md) | Iteratively drives a GitHub PR to zero unresolved Qodo findings, reading each finding's own Agent Prompt, replying to the thread, and resolving it | Fully addressing a PR against Qodo's code review before merging |
+| [relay](packages/software-development/relay/SKILL.md) | Uses `claude-relay` to run long or rate-limit-prone tasks autonomously across subscription accounts | A task will outlive one session or hit rate limits partway through |
 | [review-past-performance](packages/software-development/review-past-performance/SKILL.md) | Pulls 24h of ICM memories, git history, and skill analytics; detects repeated mistakes and slow workflows; proposes 1-3 concrete fixes | Daily self-improvement loop or codifying a repeated workflow |
+| [self-critique](packages/software-development/self-critique/SKILL.md) | Adversarially critiques your own last answer: spawns a critic agent that verifies claims against live sources, then loops until satisfied and reports where you were wrong | Checking a substantial answer before the user has to |
 | [semantic-release-beta](packages/software-development/semantic-release-beta/SKILL.md) | Sets up `semantic-release` with stable `main` releases and beta prereleases on a `beta` branch | A Node package needs stable npm publishing plus beta prereleases |
 | [skill-budget-audit](packages/software-development/skill-budget-audit/SKILL.md) | Diagnoses and fixes Claude Code's skill context budget overflow — identifies heavy plugin bundles that exceed the 2% budget | Skills failing to load or Claude hitting context limits from plugin bundles |
 | [starter-rules](packages/software-development/starter-rules/SKILL.md) | Loads and enforces hard rules for every oleg-koval/* starter | Ensuring 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, and KISS/DRY/SOLID |

package/catalog/skills.json

@@ -604,6 +604,74 @@
         "windsurf",
         "kiro"
       ]
+    },
+    {
+      "name": "add-to-my-skills",
+      "lookupName": "olko:add-to-my-skills",
+      "category": "software-development",
+      "path": "packages/software-development/add-to-my-skills",
+      "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
+      "tags": [
+        "skills",
+        "catalog",
+        "automation",
+        "git",
+        "maintenance"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "windsurf",
+        "kiro",
+        "grok"
+      ]
+    },
+    {
+      "name": "ai-tools-setup",
+      "lookupName": "olko:ai-tools-setup",
+      "category": "software-development",
+      "path": "packages/software-development/ai-tools-setup",
+      "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration.",
+      "tags": [
+        "setup",
+        "tooling",
+        "mcp",
+        "hooks",
+        "developer-experience"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "windsurf",
+        "kiro",
+        "grok"
+      ]
+    },
+    {
+      "name": "changelog-generator",
+      "lookupName": "olko:changelog-generator",
+      "category": "software-development",
+      "path": "packages/software-development/changelog-generator",
+      "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers.",
+      "tags": [
+        "changelog",
+        "git",
+        "release",
+        "documentation"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "windsurf",
+        "kiro",
+        "grok"
+      ]
     }
   ]
 }

package/package.json

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

package/packages/software-development/add-to-my-skills/adapters/claude/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "olko-add-to-my-skills",
-  "description": "Copy a newly created skill into this catalog, refresh manifests, and publish the change.",
+  "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
   "skills": "./skills"
 }

package/packages/software-development/add-to-my-skills/adapters/cursor/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "olko:add-to-my-skills",
   "version": "0.1.0",
-  "description": "Copy a newly created skill into this catalog, refresh manifests, and publish the change.",
+  "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
   "skills": "skills/"
 }

package/packages/software-development/add-to-my-skills/adapters/cursor/skills/add-to-my-skills/SKILL.md

@@ -5,7 +5,7 @@ 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 writable git repository and access to the source skill repo.
 metadata:
-  targets: [_source-only]
+  targets: ["cursor"]
   author: Oleg Koval
   tags:
     - skills

package/packages/software-development/add-to-my-skills/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:add-to-my-skills",
+  "version": "0.1.0",
+  "description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
+  "skills": "skills/"
+}

package/packages/software-development/add-to-my-skills/adapters/grok/skills/add-to-my-skills/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: add-to-my-skills
+description: Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push the change. Use when the user wants to bring a skill they built elsewhere into this repository.
+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 writable git repository and access to the source skill repo.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - skills
+    - skillshare
+    - catalog
+    - git
+    - commit
+    - push
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Add to My Skills
+
+Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.
+
+## Outcome
+
+Bring the source skill into `packages/software-development/`, register it in the catalog, refresh generated docs and adapters, and publish the change with a git commit and push.
+
+## When to Use
+
+- The user created a new `SKILL.md` in another repo and wants it added here
+- The user wants this catalog to become the canonical home for that skill
+- The user wants the README, generated manifests, commit, and push handled in one pass
+
+## Clarify Before Acting
+
+If any of these are unclear, ask up to 3 questions in one batch before editing:
+
+- Source repo or source skill path
+- Final skill name if it should differ from the source
+- Destination branch or remote if the push target is unclear
+
+Default assumptions when not specified:
+
+- Copy the source skill as a new canonical package in `packages/software-development/<skill-name>/`
+- Keep the source skill name unless the user asks to rename it
+- Use this repository as the destination
+- Commit with a conventional commit message and push to the current branch's upstream
+
+## Workflow
+
+1. Inspect the source skill:
+   - locate the source `SKILL.md`
+   - copy any supporting `references/`, `scripts/`, or `assets/` files that the skill needs
+   - note any repo-specific assumptions that need to be rewritten for this catalog
+2. Choose the package location:
+   - default to `packages/software-development/<skill-name>/`
+   - ensure the package directory name matches the `name` frontmatter value
+3. Create or update the canonical package:
+   - write `SKILL.md` first
+   - keep the frontmatter accurate and concise
+   - make the workflow explicit, actionable, and self-contained
+4. Register the package in the repository inventory:
+   - add the package to `catalog/skills.json`
+   - add it to the appropriate collection file if it belongs in a bundle
+   - update `README.md` so the package list, counts, and usage examples stay current
+5. Refresh generated outputs:
+   - run `./scripts/build-adapters.sh`
+   - run `./scripts/validate-catalog.sh`
+6. Verify the new package actually exists:
+   - confirm `packages/software-development/<skill-name>/SKILL.md`
+   - confirm generated adapter files and prompt files were created
+7. Commit and push:
+   - inspect `git status`
+   - commit the change with a conventional message
+   - push to the current upstream branch
+
+## Git Safety
+
+- Never overwrite unrelated changes
+- Never force push unless the user explicitly asks
+- Never commit secrets copied from the source repo
+- If the source skill is incomplete or ambiguous, stop and ask for clarification instead of guessing
+
+## Verification
+
+- `./scripts/build-adapters.sh` completes successfully
+- `./scripts/validate-catalog.sh` passes
+- `git status` shows only the intended package, catalog, README, and generated files
+- `git push` succeeds to the expected remote

package/packages/software-development/add-to-my-skills/adapters/kiro/steering/add-to-my-skills.md

@@ -2,7 +2,7 @@
 
 ---
 inclusion: manual
-description: "Copy a newly created skill into this catalog, refresh manifests, and publish the change."
+description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
 ---
 
 # Add to My Skills

package/packages/software-development/add-to-my-skills/adapters/windsurf/rules/add-to-my-skills.md

@@ -1,7 +1,7 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Copy a newly created skill into this catalog, refresh manifests, and publish the change."
+description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
 ---
 
 # Add to My Skills

package/packages/software-development/ai-tools-setup/adapters/claude/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "olko-ai-tools-setup",
-  "description": "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health.",
+  "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration.",
   "skills": "./skills"
 }

package/packages/software-development/ai-tools-setup/adapters/cursor/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "olko:ai-tools-setup",
   "version": "0.1.0",
-  "description": "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health.",
+  "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration.",
   "skills": "skills/"
 }

package/packages/software-development/ai-tools-setup/adapters/cursor/skills/ai-tools-setup/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 allowed-tools: Bash, Read, Edit, Write
 compatibility: Claude Code on macOS (Homebrew required)
 metadata:
-  targets: [_source-only]
+  targets: ["cursor"]
   author: Oleg Koval
   tags:
     - rtk

package/packages/software-development/ai-tools-setup/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:ai-tools-setup",
+  "version": "0.1.0",
+  "description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration.",
+  "skills": "skills/"
+}

package/packages/software-development/ai-tools-setup/adapters/grok/skills/ai-tools-setup/SKILL.md

@@ -0,0 +1,276 @@
+---
+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.'
+license: MIT
+allowed-tools: Bash, Read, Edit, Write
+compatibility: Claude Code on macOS (Homebrew required)
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - rtk
+    - icm
+    - vox
+    - setup
+    - hooks
+    - digest
+    - ai-tools
+    - productivity
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# AI Tools Setup — RTK + ICM + Vox
+
+Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.
+
+## What This Skill Does
+
+| Mode | When to use |
+|------|-------------|
+| **Setup** | First install on a new machine |
+| **Repair** | Something broke — hooks missing, MCP not loading |
+| **Digest** | Weekly check: token savings, memory health, voice stats |
+
+## Tools in the Bundle
+
+| Tool | Version | Purpose |
+|------|---------|---------|
+| **RTK** | latest | Compresses CLI output by ~89% before it reaches the model |
+| **ICM** | latest | Persistent SQLite memory across sessions (knowledge graph + hybrid search) |
+| **Vox** | latest | Spoken task notifications via local TTS — zero API calls |
+
+---
+
+## Step 1: Detect Current State
+
+Run this to see what is installed and what is missing:
+
+```bash
+echo "=== Binary check ===" && \
+  (rtk --version 2>/dev/null && echo "RTK: ok") || echo "RTK: MISSING" && \
+  (icm --version 2>/dev/null && echo "ICM: ok") || echo "ICM: MISSING" && \
+  (vox --version 2>/dev/null && echo "Vox: ok") || echo "Vox: MISSING"
+
+echo "=== RTK hook ===" && \
+  grep -c '"rtk hook claude"' ~/.claude/settings.json 2>/dev/null \
+    && echo "RTK hook: ok" || echo "RTK hook: MISSING"
+
+echo "=== ICM hooks ===" && \
+  grep -c '"icm hook' ~/.claude/settings.json 2>/dev/null \
+    && echo "ICM hooks: ok" || echo "ICM hooks: MISSING"
+
+echo "=== ICM MCP ===" && \
+  python3 -c "import json; d=json.load(open(open('$HOME/.claude.json').name)); print('ICM MCP: ok' if 'icm' in d.get('mcpServers',{}) else 'ICM MCP: MISSING')" 2>/dev/null || echo "ICM MCP: MISSING"
+
+echo "=== Vox MCP ===" && \
+  python3 -c "import json; d=json.load(open(open('$HOME/.claude.json').name)); print('Vox MCP: ok' if 'vox' in d.get('mcpServers',{}) else 'Vox MCP: MISSING')" 2>/dev/null || echo "Vox MCP: MISSING"
+
+echo "=== ICM CLAUDE.md ===" && \
+  grep -c 'icm:start' ~/.claude/CLAUDE.md 2>/dev/null \
+    && echo "ICM CLAUDE.md: ok" || echo "ICM CLAUDE.md: MISSING"
+```
+
+Read the output and determine which of the following repair steps are needed.
+
+---
+
+## Step 2: Install Missing Binaries
+
+Only run for tools that showed MISSING above.
+
+**RTK:**
+```bash
+brew install rtk
+rtk --version
+```
+
+**ICM:**
+```bash
+brew install rtk-ai/tap/icm
+icm --version
+```
+
+**Vox:**
+```bash
+brew install rtk-ai/tap/vox
+vox --version
+```
+
+---
+
+## Step 3: Repair Hooks
+
+### RTK hook missing
+
+Add the `PreToolUse` RTK hook to `~/.claude/settings.json`. Read the file first, then add inside the existing `"hooks"` block (or create one):
+
+```json
+"PreToolUse": [
+  {
+    "matcher": "Bash",
+    "hooks": [{ "type": "command", "command": "rtk hook claude" }]
+  }
+]
+```
+
+Then verify: `grep -c '"rtk hook claude"' ~/.claude/settings.json`
+
+### ICM hooks missing
+
+Run:
+```bash
+icm init --mode hook
+```
+
+This adds `PreToolUse`, `PostToolUse`, `PreCompact`, `UserPromptSubmit`, `SessionStart`, `SessionEnd` hooks automatically.
+
+### Vox Stop hook missing
+
+Run:
+```bash
+vox init --mode cli
+```
+
+---
+
+## Step 4: Repair MCP Servers
+
+### ICM MCP missing
+
+```bash
+icm init --mode mcp
+```
+
+### Vox MCP missing
+
+```bash
+vox init --mode mcp
+```
+
+Verify both by checking `~/.claude.json`:
+```bash
+python3 -c "import json; d=json.load(open('$HOME/.claude.json')); print(list(d.get('mcpServers',{}).keys()))"
+```
+
+---
+
+## Step 5: Repair CLAUDE.md Instructions
+
+If ICM instructions are missing from `~/.claude/CLAUDE.md`:
+
+```bash
+icm init --mode cli
+```
+
+Then move the block from wherever `icm init` placed it into `~/.claude/CLAUDE.md` (the global file), and remove it from any project-local files.
+
+---
+
+## Step 6: Effectiveness Digest
+
+Run this report to see how the toolkit is performing. Good to run weekly.
+
+```bash
+echo "=============================="
+echo "  AI TOOLS EFFECTIVENESS"
+echo "=============================="
+echo ""
+echo "--- RTK: Token Savings ---"
+rtk gain 2>/dev/null || echo "No data yet (run some commands first)"
+echo ""
+echo "--- ICM: Memory Health ---"
+icm health 2>/dev/null || echo "No memories yet"
+echo ""
+echo "--- ICM: Topics ---"
+icm topics 2>/dev/null || echo "No topics yet"
+echo ""
+echo "--- Vox: Usage ---"
+vox stats 2>/dev/null || echo "No stats yet"
+echo ""
+echo "=============================="
+```
+
+### What healthy output looks like
+
+- **RTK**: `Tokens saved: 5M+ (85%+)` across `500+ commands` — if savings are low, run `rtk discover` to find uncovered commands
+- **ICM**: Topics like `decisions-*`, `errors-resolved`, `preferences` with recent timestamps — if empty, start storing manually with `icm store`
+- **Vox**: Non-zero speak count means the Stop hook fired
+
+---
+
+## Step 7 (Optional): Schedule a Weekly Digest
+
+To get a weekly automated report without having to remember to run this skill:
+
+```bash
+# Create a weekly digest script
+cat > ~/ai-tools-digest.sh << 'EOF'
+#!/bin/bash
+echo "=== Weekly AI Tools Digest — $(date) ===" | tee -a ~/ai-tools-digest.log
+echo "" | tee -a ~/ai-tools-digest.log
+rtk gain 2>/dev/null | tee -a ~/ai-tools-digest.log
+echo "" | tee -a ~/ai-tools-digest.log
+icm health 2>/dev/null | tee -a ~/ai-tools-digest.log
+echo "" | tee -a ~/ai-tools-digest.log
+icm topics 2>/dev/null | tee -a ~/ai-tools-digest.log
+# Speak the summary if Vox is available
+vox "Weekly digest complete. Check your log." 2>/dev/null || true
+EOF
+chmod +x ~/ai-tools-digest.sh
+```
+
+Then set up a weekly launchd job (macOS):
+
+```bash
+cat > ~/Library/LaunchAgents/com.oleg.ai-tools-digest.plist << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.oleg.ai-tools-digest</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>/Users/oleg.koval/ai-tools-digest.sh</string>
+  </array>
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>Weekday</key>
+    <integer>1</integer>
+    <key>Hour</key>
+    <integer>9</integer>
+    <key>Minute</key>
+    <integer>0</integer>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>/tmp/ai-tools-digest.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/ai-tools-digest.err</string>
+</dict>
+</plist>
+EOF
+
+launchctl load ~/Library/LaunchAgents/com.oleg.ai-tools-digest.plist
+echo "Weekly digest scheduled for Mondays at 9am"
+```
+
+To view the digest log anytime: `cat ~/ai-tools-digest.log`
+
+To unload: `launchctl unload ~/Library/LaunchAgents/com.oleg.ai-tools-digest.plist`
+
+---
+
+## Quick Reference
+
+| Command | What it does |
+|---------|-------------|
+| `rtk gain` | Total tokens saved to date |
+| `rtk discover` | Find commands not yet covered by RTK |
+| `icm topics` | List all memory topic buckets |
+| `icm health` | Memory hygiene — stale, redundant, decay stats |
+| `icm recall "query"` | Search memories semantically |
+| `icm store -t topic -c "content" -i high` | Store a memory manually |
+| `vox "text"` | Speak text immediately |
+| `vox stats` | Usage stats for the Vox backend |
+| `cat ~/ai-tools-digest.log` | View scheduled digest history |

package/packages/software-development/ai-tools-setup/adapters/kiro/steering/ai-tools-setup.md

@@ -2,7 +2,7 @@
 
 ---
 inclusion: manual
-description: "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health."
+description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
 ---
 
 # AI Tools Setup — RTK + ICM + Vox

package/packages/software-development/ai-tools-setup/adapters/windsurf/rules/ai-tools-setup.md

@@ -1,7 +1,7 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Install, repair, and measure the RTK+ICM+Vox AI development toolkit. Fixes missing hooks and MCP config, and shows a weekly effectiveness digest of token savings and memory health."
+description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
 ---
 
 # AI Tools Setup — RTK + ICM + Vox

package/packages/software-development/changelog-generator/adapters/claude/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "olko-changelog-generator",
-  "description": "Generate user-facing changelogs and release notes from git history.",
+  "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers.",
   "skills": "./skills"
 }

package/packages/software-development/changelog-generator/adapters/cursor/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "olko:changelog-generator",
   "version": "0.1.0",
-  "description": "Generate user-facing changelogs and release notes from git history.",
+  "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers.",
   "skills": "skills/"
 }

package/packages/software-development/changelog-generator/adapters/cursor/skills/changelog-generator/SKILL.md

@@ -5,7 +5,7 @@ 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.
 metadata:
-  targets: [_source-only]
+  targets: ["cursor"]
   author: Oleg Koval
   tags:
     - changelog

package/packages/software-development/changelog-generator/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:changelog-generator",
+  "version": "0.1.0",
+  "description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers.",
+  "skills": "skills/"
+}

package/packages/software-development/changelog-generator/adapters/grok/skills/changelog-generator/SKILL.md

@@ -0,0 +1,115 @@
+---
+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.
+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.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - changelog
+    - release-notes
+    - git
+    - docs
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts.
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts

package/packages/software-development/changelog-generator/adapters/kiro/steering/changelog-generator.md

@@ -2,7 +2,7 @@
 
 ---
 inclusion: manual
-description: "Generate user-facing changelogs and release notes from git history."
+description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
 ---
 
 # Changelog Generator

package/packages/software-development/changelog-generator/adapters/windsurf/rules/changelog-generator.md

@@ -1,7 +1,7 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-description: "Generate user-facing changelogs and release notes from git history."
+description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
 ---
 
 # Changelog Generator

package/scripts/validate-catalog.sh

@@ -84,6 +84,44 @@ for (const pkg of catalog.packages) {
   }
 }
 
+// Reverse check: every skill on disk must be registered in the catalog.
+// Everything else in this file walks outward FROM the catalog, so a package the
+// catalog does not know about was invisible to validation -- which is how
+// add-to-my-skills, ai-tools-setup and changelog-generator sat unregistered
+// while still appearing in the README. Unregistered skills are absent from every
+// plugin manifest, so they cannot be installed from any marketplace.
+const registeredPaths = new Set(catalog.packages.map((pkg) => pkg.path))
+for (const category of fs.readdirSync('packages')) {
+  const categoryDir = path.join('packages', category)
+  if (!fs.statSync(categoryDir).isDirectory()) {
+    continue
+  }
+  for (const skill of fs.readdirSync(categoryDir)) {
+    const skillDir = path.join(categoryDir, skill)
+    if (!fs.statSync(skillDir).isDirectory()) {
+      continue
+    }
+    if (!fs.existsSync(path.join(skillDir, 'SKILL.md'))) {
+      continue
+    }
+    if (!registeredPaths.has(skillDir)) {
+      throw new Error(
+        `skill on disk is not registered in catalog/skills.json: ${skillDir}\n` +
+        '  Unregistered skills are missing from every plugin manifest and cannot be installed.'
+      )
+    }
+  }
+}
+
+// Every catalog package must appear in the README table, so the two inventories
+// cannot drift apart in the other direction either.
+const readme = fs.readFileSync('README.md', 'utf8')
+for (const pkg of catalog.packages) {
+  if (!readme.includes(`${pkg.path}/SKILL.md`)) {
+    throw new Error(`catalog package is missing from the README table: ${pkg.name}`)
+  }
+}
+
 for (const collectionPath of fs.readdirSync('collections').map((name) => path.join('collections', name))) {
   const collection = JSON.parse(fs.readFileSync(collectionPath, 'utf8'))
   for (const packageName of collection.packages || []) {