@olegkoval/agent-skills 1.33.0 → 1.35.0

package/.claude-plugin/marketplace.json

@@ -8,9 +8,59 @@
   },
   "plugins": [
     {
-      "name": "olko-agent-skills",
-      "source": "./",
-      "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools."
+      "name": "olko-github-pr",
+      "source": "./plugins/olko-github-pr",
+      "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage."
+    },
+    {
+      "name": "olko-git-tools",
+      "source": "./plugins/olko-git-tools",
+      "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene."
+    },
+    {
+      "name": "olko-release",
+      "source": "./plugins/olko-release",
+      "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine."
+    },
+    {
+      "name": "olko-product",
+      "source": "./plugins/olko-product",
+      "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, launch plans."
+    },
+    {
+      "name": "olko-skill-meta",
+      "source": "./plugins/olko-skill-meta",
+      "description": "Author and maintain agent skills and the AI toolchain itself."
+    },
+    {
+      "name": "olko-reflection",
+      "source": "./plugins/olko-reflection",
+      "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning."
+    },
+    {
+      "name": "olko-obsidian",
+      "source": "./plugins/olko-obsidian",
+      "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine."
+    },
+    {
+      "name": "olko-apple-kit",
+      "source": "./plugins/olko-apple-kit",
+      "description": "Build and ship Apple platform apps: macOS menubar apps, App Store submissions."
+    },
+    {
+      "name": "olko-garmin-kit",
+      "source": "./plugins/olko-garmin-kit",
+      "description": "Build, test and publish Garmin Connect IQ watch faces."
+    },
+    {
+      "name": "olko-creative",
+      "source": "./plugins/olko-creative",
+      "description": "Creative and personal projects: photo galleries, music players, listings, wiki editing."
+    },
+    {
+      "name": "olko-web-ops",
+      "source": "./plugins/olko-web-ops",
+      "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes."
     }
   ]
 }

package/.cursor-plugin/index.json

@@ -2,224 +2,59 @@
   "name": "agent-skills",
   "plugins": [
     {
-      "name": "olko:self-critique",
-      "source": "./packages/software-development/self-critique/adapters/cursor",
-      "description": "Adversarially critique your own last answer: spawn a critic agent that verifies claims against live sources, finds the related issue or pattern you missed, then loop until satisfied and report where you were wrong, iterations-to-satisfy, the numeric improvement, and a final score."
+      "name": "olko-github-pr",
+      "source": "./adapters/cursor/olko-github-pr",
+      "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage."
     },
     {
-      "name": "olko:docs-index-keeper",
-      "source": "./packages/software-development/docs-index-keeper/adapters/cursor",
-      "description": "Keep a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows."
+      "name": "olko-git-tools",
+      "source": "./adapters/cursor/olko-git-tools",
+      "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene."
     },
     {
-      "name": "olko:semantic-release-beta",
-      "source": "./packages/software-development/semantic-release-beta/adapters/cursor",
-      "description": "Set up semantic-release-npm-github-publish with stable main releases and prerelease beta releases on a beta branch."
+      "name": "olko-release",
+      "source": "./adapters/cursor/olko-release",
+      "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine."
     },
     {
-      "name": "olko:gh-cli",
-      "source": "./packages/software-development/gh-cli/adapters/cursor",
-      "description": "Use the GitHub CLI effectively for repositories, PRs, Actions, releases, and more."
+      "name": "olko-product",
+      "source": "./adapters/cursor/olko-product",
+      "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, launch plans."
     },
     {
-      "name": "olko:git-commit",
-      "source": "./packages/software-development/git-commit/adapters/cursor",
-      "description": "Create conventional commits with diff-aware staging and message generation."
+      "name": "olko-skill-meta",
+      "source": "./adapters/cursor/olko-skill-meta",
+      "description": "Author and maintain agent skills and the AI toolchain itself."
     },
     {
-      "name": "olko:gallery",
-      "source": "./packages/photography/gallery/adapters/cursor",
-      "description": "Create photo galleries with AI-assisted layout curation and sequencing."
+      "name": "olko-reflection",
+      "source": "./adapters/cursor/olko-reflection",
+      "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning."
     },
     {
-      "name": "olko:promptctl",
-      "source": "./packages/software-development/promptctl/adapters/cursor",
-      "description": "Use promptctl for template-based prompt engineering, scoring, and workflow automation."
+      "name": "olko-obsidian",
+      "source": "./adapters/cursor/olko-obsidian",
+      "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine."
     },
     {
-      "name": "olko:fill-music-player",
-      "source": "./packages/music/fill-music-player/adapters/cursor",
-      "description": "Fill a portable music player with a curated random selection from a source music library while balancing formats, artists, albums, and capacity."
+      "name": "olko-apple-kit",
+      "source": "./adapters/cursor/olko-apple-kit",
+      "description": "Build and ship Apple platform apps: macOS menubar apps, App Store submissions."
     },
     {
-      "name": "olko:product-builder",
-      "source": "./packages/software-development/product-builder/adapters/cursor",
-      "description": "Build a full-stack web application or SaaS product from a user description using production-oriented defaults."
+      "name": "olko-garmin-kit",
+      "source": "./adapters/cursor/olko-garmin-kit",
+      "description": "Build, test and publish Garmin Connect IQ watch faces."
     },
     {
-      "name": "olko:mvp-oneshot",
-      "source": "./packages/software-development/mvp-oneshot/adapters/cursor",
-      "description": "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice."
+      "name": "olko-creative",
+      "source": "./adapters/cursor/olko-creative",
+      "description": "Creative and personal projects: photo galleries, music players, listings, wiki editing."
     },
     {
-      "name": "olko:starter-rules",
-      "source": "./packages/software-development/starter-rules/adapters/cursor",
-      "description": "Load and enforce hard rules for every oleg-koval/* starter: 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, no comments, KISS/DRY/SOLID."
-    },
-    {
-      "name": "olko:review-past-performance",
-      "source": "./packages/software-development/review-past-performance/adapters/cursor",
-      "description": "Self-improvement loop that pulls the last 24h of ICM memories, git history, and skill analytics to detect repeated mistakes, slow workflows, and missing coverage, then proposes 1-3 concrete improvements."
-    },
-    {
-      "name": "olko:open-source-publisher",
-      "source": "./packages/software-development/open-source-publisher/adapters/cursor",
-      "description": "Prepare an open-source repository for public publishing with a minimal icon, social preview image, GitHub Pages site, README standardization, CI/CD checks, release hygiene, optional donation setup, and optional motion previews for generated static images."
-    },
-    {
-      "name": "olko:viral-launch",
-      "source": "./packages/marketing/viral-launch/adapters/cursor",
-      "description": "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops."
-    },
-    {
-      "name": "olko:search-console-indexing-audit",
-      "source": "./packages/marketing/search-console-indexing-audit/adapters/cursor",
-      "description": "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
-    },
-    {
-      "name": "olko:website-analytics-bootstrap",
-      "source": "./packages/marketing/website-analytics-bootstrap/adapters/cursor",
-      "description": "Set up a website's first SEO analytics loop with persistent SerpBear rank tracking, Google Search Console, seeded keywords, read-only technical audits, and Telegram alerts on a local host or NAS."
-    },
-    {
-      "name": "olko:cloudflare-block-countries",
-      "source": "./packages/software-development/cloudflare-block-countries/adapters/cursor",
-      "description": "Block specific countries via Cloudflare WAF Custom Rules using the Cloudflare API. Handles creating new rulesets and updating existing ones across single or multiple zones."
-    },
-    {
-      "name": "olko:obsidian-pr-sync",
-      "source": "./packages/software-development/obsidian-pr-sync/adapters/cursor",
-      "description": "Fetch open GitHub PRs assigned to you or requesting your review, and write a grouped, age-sorted '## PRs to review' section into today's Obsidian daily note. Idempotent — re-running replaces the section."
-    },
-    {
-      "name": "olko:obsidian-task-rollover",
-      "source": "./packages/software-development/obsidian-task-rollover/adapters/cursor",
-      "description": "Bullet-journal end-of-day task migration: copy unchecked tasks from today's Obsidian daily note to the next workday's note under '## Carried over', and mark them [>] in the source. Skips weekends, idempotent."
-    },
-    {
-      "name": "olko:apple-store-submit",
-      "source": "./packages/software-development/apple-store-submit/adapters/cursor",
-      "description": "Handle Apple App Store rejection emails end-to-end: parse rejection reasons, plan fixes, implement code changes, navigate App Store Connect, and resubmit."
-    },
-    {
-      "name": "olko:macos-menubar-app",
-      "source": "./packages/software-development/macos-menubar-app/adapters/cursor",
-      "description": "Build a production-quality macOS menubar or notch app in SwiftUI — MenuBarExtra, sandbox entitlements, keyboard shortcuts, sound effects, accessibility permissions, and App Store preparation."
-    },
-    {
-      "name": "olko:crash-course",
-      "source": "./packages/software-development/crash-course/adapters/cursor",
-      "description": "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."
-    },
-    {
-      "name": "olko:pr-finalize",
-      "source": "./packages/software-development/pr-finalize/adapters/cursor",
-      "description": "Drives one GitHub PR to genuinely merge-ready: rebases and resolves conflicts, sweeps every review bot and human comment to zero unaddressed findings, verifies unit and E2E coverage actually exists, runs the repo's real lint/format/test gates before pushing, and reports what still needs a human."
-    },
-    {
-      "name": "olko:pr-finalize-complete",
-      "source": "./packages/software-development/pr-finalize-complete/adapters/cursor",
-      "description": "Confirms a PR is genuinely merge-ready when the work is already believed done: re-checks every review-bot and human finding against the current code, separates stale comments from fixed ones, runs the repo's real lint and test gates, and reports the evidence rather than the assumption."
-    },
-    {
-      "name": "olko:qodoloop",
-      "source": "./packages/software-development/qodoloop/adapters/cursor",
-      "description": "Iteratively drives a GitHub PR to zero unresolved Qodo findings — reads each finding's own Agent Prompt, applies the fix, replies to the thread, resolves it, pushes, and waits for Qodo's next pass."
-    },
-    {
-      "name": "olko:garmin-watchface",
-      "source": "./packages/wearables/garmin-watchface/adapters/cursor",
-      "description": "Design, 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:codexloop",
-      "source": "./packages/software-development/codexloop/adapters/cursor",
-      "description": "Iteratively drives a GitHub PR to zero unresolved OpenAI Codex review comments — but verifies every finding against the real code first, fixes only the correct ones, and rebuts false positives without changing correct code."
-    },
-    {
-      "name": "olko:geminiloop",
-      "source": "./packages/software-development/geminiloop/adapters/cursor",
-      "description": "Iteratively drives a GitHub PR to zero unresolved Gemini Code Assist comments — treats each one as a claim to verify, fixes only the genuinely-correct findings, and rebuts the rest with evidence instead of editing correct code."
-    },
-    {
-      "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:wrap-up",
-      "source": "./packages/software-development/wrap-up/adapters/cursor",
-      "description": "Verify a completed task against its original objective, confirm applicable checks, and safely tidy task-owned artifacts, worktrees, and local branches."
-    },
-    {
-      "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."
-    },
-    {
-      "name": "olko:wikipedia-uk-editor",
-      "source": "./packages/software-development/wikipedia-uk-editor/adapters/cursor",
-      "description": "Draft policy-compliant Ukrainian Wikipedia edits — translate an English article into uk, expand or source an existing uk article, or fix a maintenance backlog item — and return ready-to-paste wikitext plus an edit summary."
-    },
-    {
-      "name": "olko:pr-description-writer",
-      "source": "./packages/software-development/pr-description-writer/adapters/cursor",
-      "description": "Draft and post a GitHub PR title and body from git diff and commit history. Chains after git-commit and before qodoloop / coderabbitloop."
-    },
-    {
-      "name": "olko:ci-fix-loop",
-      "source": "./packages/software-development/ci-fix-loop/adapters/cursor",
-      "description": "Diagnose GitHub Actions CI failures in a loop: fetch failing check logs, fix, push, and repeat until green. Direct analog of qodoloop / coderabbitloop for test and lint failures."
-    },
-    {
-      "name": "olko:pr-to-green",
-      "source": "./packages/software-development/pr-to-green/adapters/cursor",
-      "description": "Orchestrate a GitHub PR from first push to merge-ready: run ci-fix-loop until checks are green, detect active AI review bots, run qodoloop and coderabbitloop in sequence, and confirm zero unresolved threads."
-    },
-    {
-      "name": "olko:dependabot-triage",
-      "source": "./packages/software-development/dependabot-triage/adapters/cursor",
-      "description": "Triage open Dependabot and Renovate PRs in bulk: classify by risk tier, auto-approve and merge safe patch bumps, flag breaking major upgrades for human review, and post a digest."
-    },
-    {
-      "name": "olko:store-listing-copy",
-      "source": "./packages/software-development/store-listing-copy/adapters/cursor",
-      "description": "Generate platform-validated App Store, Google Play, and Connect IQ store listing copy (title, subtitle, description, what's new, keywords) from a git changelog or release notes."
-    },
-    {
-      "name": "olko:pr-finalize-complete",
-      "source": "./packages/software-development/pr-finalize-complete/adapters/cursor",
-      "description": "Comprehensive PR finalization workflow for PRs that may already be partially addressed: checks each review comment's actual current status in code, distinguishes fixed vs. stale vs. still-present findings, verifies test coverage, runs real lint/test gates, and reports what still needs a human."
-    },
-    {
-      "name": "olko:morning-routine",
-      "source": "./packages/software-development/morning-routine/adapters/cursor",
-      "description": "Run the complete start-of-day setup in one pass: roll over unfinished Obsidian tasks to today's daily note, sync open GitHub PRs that need your attention, and sweep Dependabot patch bumps. Chains obsidian-task-rollover, obsidian-pr-sync, and dependabot-triage."
-    },
-    {
-      "name": "olko:release-day",
-      "source": "./packages/software-development/release-day/adapters/cursor",
-      "description": "Orchestrate a full release-day workflow for iOS, Android, or Garmin apps: verify main branch CI is green, generate changelog, draft platform-ready store listing copy, trigger semantic-release or tag manually, wait for the build, and queue the App Store submission."
-    },
-    {
-      "name": "olko:branch-cleanup",
-      "source": "./packages/software-development/branch-cleanup/adapters/cursor",
-      "description": "Prune stale git branches after a merge wave: delete closed/merged remote branches, remove local tracking refs that no longer exist on the remote, and optionally clean up merged local branches. Natural follow-up to dependabot-triage."
-    },
-    {
-      "name": "olko:vinted-listing",
-      "source": "./packages/software-development/vinted-listing/adapters/cursor",
-      "description": "Create, edit, and safely publish Vinted listings through the signed-in browser, using verified item details and the owner’s original photos."
+      "name": "olko-web-ops",
+      "source": "./adapters/cursor/olko-web-ops",
+      "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes."
     }
   ]
 }

package/.github/copilot-instructions.md

@@ -0,0 +1,57 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Agent Skills Repository Instructions
+
+This repository is an opinionated agent skill catalog. Skills encode concrete defaults, preferred tools, and repeatable workflows.
+
+- Treat `catalog/skills.json` as the source of truth for plugin and skill metadata.
+- Keep canonical skill instructions in `plugins/{plugin}/skills/{skill}/SKILL.md`.
+- Regenerate every manifest and adapter with `./scripts/build-adapters.sh` after any catalog or skill metadata change.
+- Run `./scripts/validate-catalog.sh` before release.
+- Never edit a generated file directly.
+
+Available reusable prompt files:
+- pr-finalize: .github/prompts/pr-finalize.prompt.md
+- pr-finalize-complete: .github/prompts/pr-finalize-complete.prompt.md
+- pr-to-green: .github/prompts/pr-to-green.prompt.md
+- pr-description-writer: .github/prompts/pr-description-writer.prompt.md
+- qodoloop: .github/prompts/qodoloop.prompt.md
+- coderabbitloop: .github/prompts/coderabbitloop.prompt.md
+- codexloop: .github/prompts/codexloop.prompt.md
+- geminiloop: .github/prompts/geminiloop.prompt.md
+- ci-fix-loop: .github/prompts/ci-fix-loop.prompt.md
+- dependabot-triage: .github/prompts/dependabot-triage.prompt.md
+- git-commit: .github/prompts/git-commit.prompt.md
+- gh-cli: .github/prompts/gh-cli.prompt.md
+- branch-cleanup: .github/prompts/branch-cleanup.prompt.md
+- semantic-release-beta: .github/prompts/semantic-release-beta.prompt.md
+- open-source-publisher: .github/prompts/open-source-publisher.prompt.md
+- release-day: .github/prompts/release-day.prompt.md
+- changelog-generator: .github/prompts/changelog-generator.prompt.md
+- store-listing-copy: .github/prompts/store-listing-copy.prompt.md
+- product-builder: .github/prompts/product-builder.prompt.md
+- mvp-oneshot: .github/prompts/mvp-oneshot.prompt.md
+- starter-rules: .github/prompts/starter-rules.prompt.md
+- viral-launch: .github/prompts/viral-launch.prompt.md
+- add-to-my-skills: .github/prompts/add-to-my-skills.prompt.md
+- promptctl: .github/prompts/promptctl.prompt.md
+- ai-tools-setup: .github/prompts/ai-tools-setup.prompt.md
+- self-critique: .github/prompts/self-critique.prompt.md
+- review-past-performance: .github/prompts/review-past-performance.prompt.md
+- retro-analysis: .github/prompts/retro-analysis.prompt.md
+- crash-course: .github/prompts/crash-course.prompt.md
+- wrap-up: .github/prompts/wrap-up.prompt.md
+- obsidian-pr-sync: .github/prompts/obsidian-pr-sync.prompt.md
+- obsidian-task-rollover: .github/prompts/obsidian-task-rollover.prompt.md
+- morning-routine: .github/prompts/morning-routine.prompt.md
+- apple-store-submit: .github/prompts/apple-store-submit.prompt.md
+- macos-menubar-app: .github/prompts/macos-menubar-app.prompt.md
+- garmin-watchface: .github/prompts/garmin-watchface.prompt.md
+- gallery: .github/prompts/gallery.prompt.md
+- fill-music-player: .github/prompts/fill-music-player.prompt.md
+- vinted-listing: .github/prompts/vinted-listing.prompt.md
+- wikipedia-uk-editor: .github/prompts/wikipedia-uk-editor.prompt.md
+- cloudflare-block-countries: .github/prompts/cloudflare-block-countries.prompt.md
+- search-console-indexing-audit: .github/prompts/search-console-indexing-audit.prompt.md
+- docs-index-keeper: .github/prompts/docs-index-keeper.prompt.md
+- website-analytics-bootstrap: .github/prompts/website-analytics-bootstrap.prompt.md

package/{packages/software-development/add-to-my-skills/adapters/windsurf/rules/add-to-my-skills.md → .github/prompts/add-to-my-skills.prompt.md}

@@ -4,6 +4,8 @@
 description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
 ---
 
+Use the olko:add-to-my-skills skill.
+
 # 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/{packages/software-development/ai-tools-setup/adapters/kiro/steering/ai-tools-setup.md → .github/prompts/ai-tools-setup.prompt.md}

@@ -1,10 +1,11 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-inclusion: manual
 description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
 ---
 
+Use the olko:ai-tools-setup skill.
+
 # AI Tools Setup — RTK + ICM + Vox
 
 Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.

package/{packages/software-development/apple-store-submit/adapters/kiro/steering/apple-store-submit.md → .github/prompts/apple-store-submit.prompt.md}

@@ -1,10 +1,11 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-inclusion: manual
 description: "Handle Apple App Store rejection emails end-to-end: parse rejection reasons, plan fixes, implement code changes, navigate App Store Connect, and resubmit."
 ---
 
+Use the olko:apple-store-submit skill.
+
 > 🤖 *Auto-generated by **weekly-pattern-learner** · App Store rejection handling workflow observed in FocusNotch App Store session, Jun 2026 (92 user turns covering rejection → plan → code fixes → metadata → resubmit)*
 
 # Apple App Store Submission & Rejection Handling

package/.github/prompts/branch-cleanup.prompt.md

@@ -0,0 +1,186 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+description: "Prune stale git branches after a merge wave: delete closed/merged remote branches, remove local tracking refs that no longer exist on the remote, and optionally clean up merged local branches. Natural follow-up to dependabot-triage."
+---
+
+Use the olko:branch-cleanup skill.
+
+> 🤖 *Auto-generated by **weekly-pattern-learner** · dependabot-triage was added to merge dependency PRs in bulk but leaves stale remote branches behind; no skill follows up to prune them*
+
+# Branch Cleanup
+
+Remove stale remote and local branches safely after a merge wave. Defaults to
+dry-run so you see exactly what will be deleted before anything is removed.
+
+## Inputs
+
+- **Remote** (optional, default: `origin`)
+- **Base branch** (optional, default: `main` — detect from `gh repo view`)
+- **--dry-run** (optional, default: on): preview deletions without executing them
+- **--execute**: actually delete branches (requires explicit flag — safety default)
+- **--include-local**: also clean up merged local branches (off by default)
+
+## Step 1 — Fetch and prune remote tracking references
+
+Always start here. This removes local tracking refs for remote branches that are
+already gone, without touching anything else:
+
+```bash
+REMOTE="${Remote:-origin}"
+git fetch --prune "$REMOTE"
+```
+
+After pruning, print the count of removed tracking refs:
+
+```bash
+git branch -vv | grep ': gone]' | wc -l
+```
+
+## Step 2 — Identify stale remote branches
+
+Find remote branches whose associated PR is merged or closed:
+
+```bash
+# Get all non-default remote branches
+BASE=$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name' 2>/dev/null || echo "main")
+
+git branch -r --merged "$REMOTE/$BASE" \
+  | grep -v "HEAD" \
+  | grep -v "$REMOTE/$BASE" \
+  | sed "s|$REMOTE/||" \
+  | sort
+```
+
+Cross-reference with GitHub to confirm each branch's PR state. Only include branches
+with a confirmed merged or closed PR — an empty result means the branch is not eligible:
+
+```bash
+STALE_BRANCHES=()
+for branch in $(git branch -r --merged "$REMOTE/$BASE" \
+    | grep -v HEAD | grep -v "$REMOTE/$BASE" | sed "s|$REMOTE/||"); do
+  PR_DATA=$(gh pr list --head "$branch" --state merged \
+    --json number,title,mergedAt \
+    --jq '.[0] | "\(.number) merged \(.mergedAt | .[0:10])"' 2>/dev/null)
+  if [ -z "$PR_DATA" ]; then
+    PR_DATA=$(gh pr list --head "$branch" --state closed \
+      --json number,title,closedAt \
+      --jq '.[0] | "\(.number) closed \(.closedAt | .[0:10])"' 2>/dev/null)
+  fi
+  if [ -n "$PR_DATA" ]; then
+    echo "$branch  ←  $PR_DATA"
+    STALE_BRANCHES+=("$branch")
+  else
+    echo "$branch  ←  no confirmed PR (skipped)"
+  fi
+done
+```
+
+This produces a table like:
+
+```
+dependabot/npm_and_yarn/lodash-4.17.21   ←  42 merged 2026-07-31
+dependabot/npm_and_yarn/eslint-8.57.0    ←  43 merged 2026-07-31
+feature/login-refresh                    ←  38 merged 2026-07-28
+```
+
+## Step 3 — Safety filter
+
+**Never propose deletion of:**
+
+| Branch | Reason |
+|--------|--------|
+| `main`, `master`, `develop` | Protected base branches |
+| `beta`, `staging`, `production` | Release/deploy targets |
+| Any branch with an open PR | May still be in review |
+| Any branch not yet merged to base | Would lose commits |
+| Branches the user has modified locally in the last 24h | Work-in-progress |
+
+Check for open PRs before including a branch in the deletion list:
+
+```bash
+OPEN=$(gh pr list --head "$branch" --state open --json number --jq 'length')
+[ "$OPEN" -gt 0 ] && echo "SKIP (open PR): $branch"
+```
+
+## Step 4 — Preview or execute
+
+### Dry-run (default)
+
+Print the deletion plan and stop. Never touch the remote without `--execute`:
+
+```
+Branch cleanup preview — dry-run (pass --execute to apply)
+
+  Remote branches to delete (all merged to main):
+    origin/dependabot/npm_and_yarn/lodash-4.17.21     (PR #42, merged 2026-07-31)
+    origin/dependabot/npm_and_yarn/eslint-8.57.0      (PR #43, merged 2026-07-31)
+    origin/feature/login-refresh                       (PR #38, merged 2026-07-28)
+
+  Local tracking refs already pruned: 3 (by git fetch --prune)
+
+  Would NOT delete:
+    origin/beta            (protected release branch)
+    origin/feature/signup  (open PR #47)
+
+  Run with --execute to apply.
+```
+
+### Execute
+
+```bash
+# Delete remote branches
+for branch in "${STALE_BRANCHES[@]}"; do
+  git push "$REMOTE" --delete "$branch" && echo "deleted: $REMOTE/$branch"
+done
+```
+
+## Step 5 — Local branch cleanup (optional, --include-local)
+
+Only runs when `--include-local` is explicitly passed.
+
+Find local branches already merged to base and not checked out:
+
+```bash
+git branch --merged "$BASE" \
+  | grep -v "^\*" \
+  | grep -v "$BASE" \
+  | grep -v "main\|master\|develop\|beta\|staging"
+```
+
+For each candidate, confirm there is no uncommitted work and the tracking ref is
+gone before deleting:
+
+```bash
+git branch -vv "$branch"   # should show ': gone]' if remote is deleted
+git branch -d "$branch"    # safe delete — fails if unmerged work exists
+```
+
+Never use `-D` (force delete) — let `-d` protect you from accidental data loss.
+
+## Report
+
+```
+Branch cleanup complete
+
+  Remote:
+    Deleted:   12 branches (10 Dependabot, 2 feature branches — all merged)
+    Protected: 2 skipped (beta, open PR)
+
+  Local tracking refs:
+    Pruned:    12 stale refs (git fetch --prune)
+
+  Local branches (--include-local):
+    Deleted:   3 branches already merged to main
+    Kept:      1 branch (has uncommitted work)
+
+  Repo now has: N remote branches, M local branches
+```
+
+## Chaining
+
+| Before this skill | After this skill |
+|---|---|
+| `olko:dependabot-triage` (merged patch PRs) | next `olko:morning-routine` starts clean |
+| Sprint wind-down / milestone close | `git fetch` confirms clean state |
+| Any large batch merge | nothing — maintenance complete |

package/{packages/software-development/changelog-generator/adapters/windsurf/rules/changelog-generator.md → .github/prompts/changelog-generator.prompt.md}

@@ -4,6 +4,8 @@
 description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
 ---
 
+Use the olko:changelog-generator skill.
+
 # Changelog Generator
 
 This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.