@olegkoval/agent-skills 1.28.0 → 1.30.0

package/catalog/skills.json

@@ -628,7 +628,7 @@
       "lookupName": "olko:garmin-watchface",
       "category": "wearables",
       "path": "packages/wearables/garmin-watchface",
-      "description": "Build, test, screenshot and publish Garmin Connect IQ watch faces in Monkey C.",
+      "description": "Design, build, test, screenshot and publish Garmin Connect IQ watch faces in Monkey C.",
       "tags": [
         "garmin",
         "connect-iq",
@@ -930,6 +930,122 @@
         "copilot",
         "grok"
       ]
+    },
+    {
+      "name": "pr-finalize-complete",
+      "lookupName": "olko:pr-finalize-complete",
+      "category": "software-development",
+      "path": "packages/software-development/pr-finalize-complete",
+      "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.",
+      "tags": [
+        "code-review",
+        "pull-requests",
+        "github",
+        "testing",
+        "automation",
+        "verification"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
+    },
+    {
+      "name": "morning-routine",
+      "lookupName": "olko:morning-routine",
+      "category": "software-development",
+      "path": "packages/software-development/morning-routine",
+      "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.",
+      "tags": [
+        "morning",
+        "obsidian",
+        "daily-note",
+        "github",
+        "dependabot",
+        "productivity",
+        "routine",
+        "automation"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
+    },
+    {
+      "name": "release-day",
+      "lookupName": "olko:release-day",
+      "category": "software-development",
+      "path": "packages/software-development/release-day",
+      "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.",
+      "tags": [
+        "release",
+        "ios",
+        "android",
+        "garmin",
+        "app-store",
+        "changelog",
+        "store-listing",
+        "semantic-release",
+        "deployment",
+        "automation"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
+    },
+    {
+      "name": "branch-cleanup",
+      "lookupName": "olko:branch-cleanup",
+      "category": "software-development",
+      "path": "packages/software-development/branch-cleanup",
+      "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.",
+      "tags": [
+        "git",
+        "branches",
+        "cleanup",
+        "maintenance",
+        "dependabot",
+        "github"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
+    },
+    {
+      "name": "vinted-listing",
+      "lookupName": "olko:vinted-listing",
+      "category": "software-development",
+      "path": "packages/software-development/vinted-listing",
+      "description": "Create, edit, and safely publish Vinted listings through the signed-in browser, using verified item details and the owner’s original photos.",
+      "tags": [
+        "vinted",
+        "marketplace",
+        "selling",
+        "browser",
+        "photos",
+        "moderation"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
     }
   ]
 }

package/collections/software-development.json

@@ -11,6 +11,7 @@
     "open-source-publisher",
     "product-builder",
     "mvp-oneshot",
-    "wikipedia-uk-editor"
+    "wikipedia-uk-editor",
+    "vinted-listing"
   ]
 }

package/package.json

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

package/packages/software-development/branch-cleanup/SKILL.md

@@ -0,0 +1,204 @@
+---
+name: branch-cleanup
+description: >
+  Prune stale git branches after a merge wave: delete closed/merged remote branches,
+  remove local tracking branches that no longer exist on the remote, and optionally
+  clean up local branches already merged to main. Use after running dependabot-triage,
+  after a sprint wind-down, or when the user says "clean up branches", "prune branches",
+  "delete merged branches", or "tidy up git".
+license: MIT
+allowed-tools: Bash
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git and gh (GitHub CLI) authenticated.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - git
+    - branches
+    - cleanup
+    - maintenance
+    - dependabot
+    - github
+source: weekly-pattern-learner
+source_reason: "dependabot-triage was added to merge dependency PRs in bulk but leaves stale remote branches behind; no skill follows up to prune them"
+source_date: "2026-08-10"
+---
+
+> 🤖 *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/branch-cleanup/adapters/claude/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-branch-cleanup",
+  "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.",
+  "skills": "./skills"
+}

package/packages/software-development/branch-cleanup/adapters/claude/skills/branch-cleanup/SKILL.md

@@ -0,0 +1,205 @@
+---
+name: branch-cleanup
+description: >
+  Prune stale git branches after a merge wave: delete closed/merged remote branches,
+  remove local tracking branches that no longer exist on the remote, and optionally
+  clean up local branches already merged to main. Use after running dependabot-triage,
+  after a sprint wind-down, or when the user says "clean up branches", "prune branches",
+  "delete merged branches", or "tidy up git".
+license: MIT
+allowed-tools: Bash
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git and gh (GitHub CLI) authenticated.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - git
+    - branches
+    - cleanup
+    - maintenance
+    - dependabot
+    - github
+source: weekly-pattern-learner
+source_reason: "dependabot-triage was added to merge dependency PRs in bulk but leaves stale remote branches behind; no skill follows up to prune them"
+source_date: "2026-08-10"
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+> 🤖 *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/branch-cleanup/adapters/codex/README.md

@@ -0,0 +1,19 @@
+# Codex Adapter for branch-cleanup
+
+This is a Codex-specific adapter for the `olko:branch-cleanup` skill.
+The canonical skill definition is in `../../SKILL.md`.
+
+## Usage
+
+Invoke in a Codex session:
+
+```text
+Use the olko:branch-cleanup skill to prune stale branches after the Dependabot merge wave.
+```
+
+## Workflow
+
+See `../../SKILL.md` for the full workflow: fetch and prune remote tracking refs, identify
+merged/closed remote branches via GitHub PR state, safety-filter protected and open-PR
+branches, preview or execute deletions, and optionally clean up merged local branches.
+Defaults to dry-run — pass --execute to apply. The procedure is plain git/gh and is agent-agnostic.

package/packages/software-development/branch-cleanup/adapters/cursor/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:branch-cleanup",
+  "version": "0.1.0",
+  "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.",
+  "skills": "skills/"
+}