@olegkoval/agent-skills 1.20.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.19.1",
+  "version": "1.21.0",
   "author": {
     "name": "Oleg Koval"
   },
@@ -33,6 +33,10 @@
     "./packages/software-development/skill-budget-audit",
     "./packages/software-development/crash-course",
     "./packages/software-development/qodoloop",
-    "./packages/wearables/garmin-watchface"
+    "./packages/wearables/garmin-watchface",
+    "./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

@@ -115,6 +115,26 @@
       "name": "olko:garmin-watchface",
       "source": "./packages/wearables/garmin-watchface/adapters/cursor",
       "description": "Build, test, screenshot and publish Garmin Connect IQ watch faces in Monkey C."
+    },
+    {
+      "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

@@ -125,6 +125,26 @@
       "name": "olko:garmin-watchface",
       "source": "./packages/wearables/garmin-watchface/adapters/grok",
       "description": "Build, test, screenshot and publish Garmin Connect IQ watch faces in Monkey C."
+    },
+    {
+      "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/.kiro/steering/coderabbitloop.md

@@ -0,0 +1,109 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+inclusion: manual
+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."
+---
+
+# Coderabbitloop
+
+Fix every actionable CodeRabbit finding on a PR, answer each thread, resolve it, and keep going until CodeRabbit has nothing left to say (or a finding needs a human call).
+
+## Inputs
+
+- **PR number** (optional): detect from the current branch if not given.
+
+## How CodeRabbit actually posts (verified against docs.coderabbit.ai and a live install — don't assume otherwise)
+
+CodeRabbit runs as `coderabbitai[bot]` and posts **two independent things**, not one:
+
+1. An auto-generated **walkthrough/summary issue comment** — body starts with the HTML marker `<!-- This is an auto-generated comment: summarize by coderabbit.ai -->`. This is a description, not a review — use it for context only, never as a source of fixable findings.
+2. A **formal PR review** carrying one **inline review comment per finding**, each a real, resolvable GitHub review thread at the finding's file/line. Each one contains a `<details><summary>🤖 Prompt for AI Agents</summary>` block: a ready-made fix spec, CodeRabbit's own words, meant to be handed straight to an agent.
+
+**Use the inline threads as the source of truth**, exactly like Greptile/Qodo — fetch via GraphQL `reviewThreads`, which carries native `isResolved` state (see `references/graphql-queries.md`, shared with `qodoloop`; only the bot login and the prompt-heading text differ).
+
+CodeRabbit has slash commands (official, `docs.coderabbit.ai/reference/review-commands`) — the ones this loop actually uses:
+- `@coderabbitai review` — incremental review of new changes (use this to re-trigger after a push, if automatic review-on-push is off for this repo).
+- `@coderabbitai resolve` — marks **all** CodeRabbit threads resolved in one shot. This is a bulk escape hatch, not the default path: this loop resolves threads one at a time, right after replying to each, so the reply-then-resolve record stays intact per finding.
+- CodeRabbit also has its own built-in `@coderabbitai autofix`, which commits fixes directly without a model in the loop. Mention it to the user as an alternative if they'd rather skip the loop entirely, but this skill's whole point is the Claude-orchestrated version — don't default to autofix instead of doing the work.
+
+**Rate limit is a real terminal state, not a bug.** A comment reading "you've reached your PR review limit" (confirmed live wording) means CodeRabbit will not review again this cycle — stop and report it, don't loop waiting for something that isn't coming.
+
+## Instructions
+
+### 1. Identify the PR
+
+```bash
+gh pr view --json number,headRefName,headRefOid -q '{number, branch: .headRefName, sha: .headRefOid}'
+```
+
+Check out the branch if not already on it.
+
+### 2. Loop (max 5 iterations)
+
+#### A. Push and wait
+
+```bash
+git push
+```
+
+If this repo doesn't auto-review on push, nudge it:
+
+```bash
+gh pr comment <PR_NUMBER> --body "@coderabbitai review"
+```
+
+Poll (every ~10s, timeout ~5min) for CodeRabbit's next formal review to land — a new entry in `gh api repos/{owner}/{repo}/pulls/<PR_NUMBER>/reviews` from `coderabbitai[bot]` created after this push. If you instead see a rate-limit comment ("review limit"), **stop the loop now** and go to Report with `blocked: rate-limited`.
+
+#### B. Fetch unresolved findings
+
+Run the `unresolvedQodoThreads`-shaped query in `references/graphql-queries.md` (filter `author.login == "coderabbitai[bot]"` instead of Qodo's login). For each unresolved thread, parse the finding text and the **Prompt for AI Agents** block (heading text is `🤖 Prompt for AI Agents`, not `Agent Prompt` — match case/emoji-insensitively).
+
+#### C. Check exit conditions
+
+Stop if there are zero unresolved CodeRabbit threads, or max iterations reached.
+
+#### D. Fix each finding
+
+For each thread, in order: read the Prompt for AI Agents block in full — it names the issue and the fix. Apply it, staying inside its stated scope. If the suggestion is wrong, unsafe, or needs a product decision, don't force it — note that in step E instead.
+
+#### E. Answer and resolve
+
+**Reply to the thread first, then resolve it** — the "answer to the comments" half of the job:
+
+```bash
+gh api graphql -f query='mutation { addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId: "<THREAD_ID>", body: "<REPLY>"}) { comment { id } } }'
+```
+
+Reply body: one or two sentences — what you changed and why, or exactly why you didn't fix it. Then resolve (`resolveReviewThread`). A finding you deliberately skip still gets a reply and gets resolved.
+
+#### F. Commit and push
+
+```bash
+git add -A
+git commit -m "address CodeRabbit review feedback (coderabbitloop iteration N)"
+git push
+```
+
+Go back to step A.
+
+### 3. Report
+
+| Field              | Value |
+|--------------------|-------|
+| Iterations         | N     |
+| Findings resolved  | N     |
+| Findings skipped   | N (with reasons) |
+| Remaining          | N (if any) |
+| Blocked            | rate-limited / max-iterations / none |
+
+```
+Coderabbitloop complete.
+  Iterations:  2
+  Resolved:    4 (3 fixed, 1 false-positive, replied + resolved)
+  Remaining:   0
+```
+
+## References
+
+- `references/graphql-queries.md` — shared with `qodoloop`: the exact `reviewThreads` query and the `resolveReviewThread` / `addPullRequestReviewThreadReply` mutations. Swap the author-login filter to `coderabbitai[bot]` and the prompt-heading match to `Prompt for AI Agents`.

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/.windsurf/rules/coderabbitloop.md

@@ -0,0 +1,108 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+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."
+---
+
+# Coderabbitloop
+
+Fix every actionable CodeRabbit finding on a PR, answer each thread, resolve it, and keep going until CodeRabbit has nothing left to say (or a finding needs a human call).
+
+## Inputs
+
+- **PR number** (optional): detect from the current branch if not given.
+
+## How CodeRabbit actually posts (verified against docs.coderabbit.ai and a live install — don't assume otherwise)
+
+CodeRabbit runs as `coderabbitai[bot]` and posts **two independent things**, not one:
+
+1. An auto-generated **walkthrough/summary issue comment** — body starts with the HTML marker `<!-- This is an auto-generated comment: summarize by coderabbit.ai -->`. This is a description, not a review — use it for context only, never as a source of fixable findings.
+2. A **formal PR review** carrying one **inline review comment per finding**, each a real, resolvable GitHub review thread at the finding's file/line. Each one contains a `<details><summary>🤖 Prompt for AI Agents</summary>` block: a ready-made fix spec, CodeRabbit's own words, meant to be handed straight to an agent.
+
+**Use the inline threads as the source of truth**, exactly like Greptile/Qodo — fetch via GraphQL `reviewThreads`, which carries native `isResolved` state (see `references/graphql-queries.md`, shared with `qodoloop`; only the bot login and the prompt-heading text differ).
+
+CodeRabbit has slash commands (official, `docs.coderabbit.ai/reference/review-commands`) — the ones this loop actually uses:
+- `@coderabbitai review` — incremental review of new changes (use this to re-trigger after a push, if automatic review-on-push is off for this repo).
+- `@coderabbitai resolve` — marks **all** CodeRabbit threads resolved in one shot. This is a bulk escape hatch, not the default path: this loop resolves threads one at a time, right after replying to each, so the reply-then-resolve record stays intact per finding.
+- CodeRabbit also has its own built-in `@coderabbitai autofix`, which commits fixes directly without a model in the loop. Mention it to the user as an alternative if they'd rather skip the loop entirely, but this skill's whole point is the Claude-orchestrated version — don't default to autofix instead of doing the work.
+
+**Rate limit is a real terminal state, not a bug.** A comment reading "you've reached your PR review limit" (confirmed live wording) means CodeRabbit will not review again this cycle — stop and report it, don't loop waiting for something that isn't coming.
+
+## Instructions
+
+### 1. Identify the PR
+
+```bash
+gh pr view --json number,headRefName,headRefOid -q '{number, branch: .headRefName, sha: .headRefOid}'
+```
+
+Check out the branch if not already on it.
+
+### 2. Loop (max 5 iterations)
+
+#### A. Push and wait
+
+```bash
+git push
+```
+
+If this repo doesn't auto-review on push, nudge it:
+
+```bash
+gh pr comment <PR_NUMBER> --body "@coderabbitai review"
+```
+
+Poll (every ~10s, timeout ~5min) for CodeRabbit's next formal review to land — a new entry in `gh api repos/{owner}/{repo}/pulls/<PR_NUMBER>/reviews` from `coderabbitai[bot]` created after this push. If you instead see a rate-limit comment ("review limit"), **stop the loop now** and go to Report with `blocked: rate-limited`.
+
+#### B. Fetch unresolved findings
+
+Run the `unresolvedQodoThreads`-shaped query in `references/graphql-queries.md` (filter `author.login == "coderabbitai[bot]"` instead of Qodo's login). For each unresolved thread, parse the finding text and the **Prompt for AI Agents** block (heading text is `🤖 Prompt for AI Agents`, not `Agent Prompt` — match case/emoji-insensitively).
+
+#### C. Check exit conditions
+
+Stop if there are zero unresolved CodeRabbit threads, or max iterations reached.
+
+#### D. Fix each finding
+
+For each thread, in order: read the Prompt for AI Agents block in full — it names the issue and the fix. Apply it, staying inside its stated scope. If the suggestion is wrong, unsafe, or needs a product decision, don't force it — note that in step E instead.
+
+#### E. Answer and resolve
+
+**Reply to the thread first, then resolve it** — the "answer to the comments" half of the job:
+
+```bash
+gh api graphql -f query='mutation { addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId: "<THREAD_ID>", body: "<REPLY>"}) { comment { id } } }'
+```
+
+Reply body: one or two sentences — what you changed and why, or exactly why you didn't fix it. Then resolve (`resolveReviewThread`). A finding you deliberately skip still gets a reply and gets resolved.
+
+#### F. Commit and push
+
+```bash
+git add -A
+git commit -m "address CodeRabbit review feedback (coderabbitloop iteration N)"
+git push
+```
+
+Go back to step A.
+
+### 3. Report
+
+| Field              | Value |
+|--------------------|-------|
+| Iterations         | N     |
+| Findings resolved  | N     |
+| Findings skipped   | N (with reasons) |
+| Remaining          | N (if any) |
+| Blocked            | rate-limited / max-iterations / none |
+
+```
+Coderabbitloop complete.
+  Iterations:  2
+  Resolved:    4 (3 fixed, 1 false-positive, replied + resolved)
+  Remaining:   0
+```
+
+## References
+
+- `references/graphql-queries.md` — shared with `qodoloop`: the exact `reviewThreads` query and the `resolveReviewThread` / `addPullRequestReviewThreadReply` mutations. Swap the author-login filter to `coderabbitai[bot]` and the prompt-heading match to `Prompt for AI Agents`.

package/README.md

@@ -136,11 +136,11 @@ packages/{category}/{skill}/SKILL.md
 
 </details>
 
-## All 25 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 |
 |-------|-------------|----------|
@@ -149,6 +149,7 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
 | [apple-store-submit](packages/software-development/apple-store-submit/SKILL.md) | Handles App Store rejection emails end-to-end — parses rejection reasons, creates a fix plan, implements code changes, and prepares resubmission | Responding to App Store rejections for privacy strings, entitlements, or guideline violations |
 | [changelog-generator](packages/software-development/changelog-generator/SKILL.md) | Transforms git commits into polished user-facing changelogs by categorising changes and rewriting technical commit messages | Preparing release notes, app store update descriptions, or a public changelog |
 | [cloudflare-block-countries](packages/software-development/cloudflare-block-countries/SKILL.md) | Blocks specific countries via Cloudflare WAF Custom Rules using the API | Geo-blocking traffic or setting up WAF country rules across single or multiple zones |
+| [coderabbitloop](packages/software-development/coderabbitloop/SKILL.md) | Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings, reading each inline comment's own Prompt for AI Agents block, replying to the thread, and resolving it | Fully addressing a PR against CodeRabbit's review before merging |
 | [crash-course](packages/software-development/crash-course/SKILL.md) | Expert tutor for rapid, source-grounded learning of any topic: a timed 4-hour sprint plus cheat-sheet, learning-ladder, quiz-me, Feynman, and resource-curation modes | Ramping up on an unfamiliar codebase, project, or concept under time pressure |
 | [docs-index-keeper](packages/software-development/docs-index-keeper/SKILL.md) | Keeps a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows | A repo has `docs/` and needs `docs/README.md` updated automatically |
 | [gh-cli](packages/software-development/gh-cli/SKILL.md) | Guides GitHub CLI usage for repos, PRs, Actions, releases, issues, and all related GitHub operations | Working with GitHub from the command line and needing reliable `gh` commands |
@@ -161,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

@@ -580,6 +580,98 @@
         "kiro",
         "grok"
       ]
+    },
+    {
+      "name": "coderabbitloop",
+      "lookupName": "olko:coderabbitloop",
+      "category": "software-development",
+      "path": "packages/software-development/coderabbitloop",
+      "description": "Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings \u2014 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.",
+      "tags": [
+        "code-review",
+        "coderabbit",
+        "github",
+        "pull-requests",
+        "automation",
+        "agents"
+      ],
+      "adapters": [
+        "claude",
+        "codex",
+        "cursor",
+        "copilot",
+        "grok",
+        "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.20.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