@olegkoval/agent-skills 1.28.0 → 1.30.0

package/packages/software-development/branch-cleanup/adapters/cursor/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: ["cursor"]
+  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/grok/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/"
+}

package/packages/software-development/branch-cleanup/adapters/grok/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/morning-routine/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: 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/Renovate PRs to clear safe patch bumps. Use when the user says "start my
+  day", "morning routine", "set up my day", or when a scheduled morning job fires.
+license: MIT
+allowed-tools: Bash, Read, Write, Edit
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires git and gh (GitHub CLI) authenticated, plus a daily-note vault path configured.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - morning
+    - obsidian
+    - daily-note
+    - github
+    - dependabot
+    - productivity
+    - routine
+    - automation
+source: weekly-pattern-learner
+source_reason: "obsidian-task-rollover, obsidian-pr-sync, and dependabot-triage all describe themselves as morning-routine steps but no meta-skill chains them into a single first-thing-of-day pass"
+source_date: "2026-08-10"
+---
+
+> 🤖 *Auto-generated by **weekly-pattern-learner** · obsidian-task-rollover, obsidian-pr-sync, and dependabot-triage all describe themselves as morning-routine steps but no meta-skill chains them into a single first-thing-of-day pass*
+
+# Morning Routine
+
+Run the three start-of-day workflows in sequence, then summarize what needs your
+attention today. Each phase is idempotent — re-running is safe.
+
+## Inputs
+
+- **VAULT_DAILY** (required): absolute path to the Obsidian daily notes folder
+- **GH_USERNAME** (required): GitHub login for PR filtering
+- **ORG_PREFIX** (optional): org name to group as "Work" in the PR section
+- **--skip-rollover** (optional): skip task rollover (e.g. Monday after a break)
+- **--skip-pr-sync** (optional): skip GitHub PR sync
+- **--skip-dependabot** (optional): skip Dependabot triage
+
+If any required config is missing, ask once before starting — don't abort midway.
+
+## Phase 1 — Task rollover
+
+Initialize the daily note path once, before any optional phase:
+
+```bash
+NOTE="${VAULT_DAILY}/$(date +%Y-%m-%d).md"
+```
+
+Run `olko:obsidian-task-rollover` on the **previous workday's** note.
+
+`obsidian-task-rollover` is an end-of-day migration skill — it copies unchecked tasks
+from a given day's note into the next workday's note with a `[>]` marker. When invoked
+here in the morning, it should operate on **yesterday's** (or the last workday's) note
+so those unchecked tasks are pulled forward into today's note. If yesterday's note does
+not exist, skip this step and note it in the report.
+
+**Skip if** `--skip-rollover` is set, or if it's Monday and the user has explicitly
+said they clear the board on Fridays.
+
+After this phase, confirm:
+```bash
+grep -c "^\- \[ \]" "$NOTE" 2>/dev/null || echo "0"  # open tasks today
+grep -c "^\- \[>\]" "$NOTE" 2>/dev/null || echo "0"  # migrated tasks
+```
+
+Record counts for the final report.
+
+## Phase 2 — PR sync
+
+Run `olko:obsidian-pr-sync`.
+
+This fetches all open GitHub PRs where the user is assignee or review-requested,
+filters out bots and drafts, and writes or replaces the `## PRs to review` section
+in today's daily note. PRs are grouped into Work (ORG_PREFIX org) and Personal.
+
+**Skip if** `--skip-pr-sync` is set.
+
+After this phase, count PRs written:
+```bash
+grep -c "^\- \[ \] \[" "$NOTE" 2>/dev/null || echo "0"
+```
+
+## Phase 3 — Dependabot triage (quick sweep)
+
+Run `olko:dependabot-triage` with `patch-only` auto-merge policy.
+
+This auto-approves and merges safe patch bumps whose CI is green, flags major
+upgrades for human review, and posts a digest. The `patch-only` policy means no
+minor or major bumps are merged automatically — just the safest dependency noise.
+
+**Skip if** `--skip-dependabot` is set, or if there are no open dependency PRs:
+
+```bash
+gh pr list --state open \
+  --json author --jq '
+    [.[] | select(.author.login | test("dependabot|renovate"; "i"))]
+    | length
+  ' 2>/dev/null
+```
+
+If the count is 0, skip phase 3 and note it in the report.
+
+## Final report
+
+Print a compact brief suitable for the start of the day:
+
+```
+Morning routine complete — YYYY-MM-DD
+
+  Tasks:        N open today (M carried over from yesterday)
+  PRs:          X work PRs, Y personal PRs → see ## PRs to review in today's note
+  Dependabot:   Z merged (patch, CI green), W flagged for review
+
+  Today's top 3:
+    [read from ## Top 3 for today section if populated, else print "(not filled in yet)"]
+
+  Flagged for you:
+    - [PRs older than 7 days ⚠️ from the PR sync, if any]
+    - [Major Dependabot bumps flagged for human decision, if any]
+```
+
+If a phase failed (auth expired, vault not found, network error), surface the error
+clearly rather than silently skipping that phase.
+
+## Invocation patterns
+
+**Manual (user-triggered):**
+User says "start my day", "run morning routine", or "set up today's note".
+Run the full flow and show the final report.
+
+**Scheduled (cron / CCR):**
+No user prompt needed. Run all three phases silently and emit the report as the
+run's output. Useful as a pre-meeting brief or as a first message in a new session.
+
+**Partial run:**
+If the user wants to re-sync only PRs mid-day: `--skip-rollover --skip-dependabot`.
+
+## Chaining
+
+| Before this skill | After this skill |
+|---|---|
+| — (start of session) | Work the PR queue (`olko:pr-to-green` on flagged items) |
+| — | `olko:dependabot-triage` with `patch-and-minor` if the quick sweep flagged many |
+| `olko:obsidian-task-rollover` alone | nothing — this skill already calls it |

package/packages/software-development/morning-routine/adapters/claude/plugin.json

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