@olegkoval/agent-skills 1.21.1 → 1.23.0

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.21.0",
+  "version": "1.22.0",
   "author": {
     "name": "Oleg Koval"
   },
@@ -37,6 +37,9 @@
     "./packages/software-development/coderabbitloop",
     "./packages/software-development/add-to-my-skills",
     "./packages/software-development/ai-tools-setup",
-    "./packages/software-development/changelog-generator"
+    "./packages/software-development/changelog-generator",
+    "./packages/software-development/wikipedia-uk-editor",
+    "./packages/software-development/pr-description-writer",
+    "./packages/software-development/ci-fix-loop"
   ]
 }

package/.cursor-plugin/index.json

@@ -135,6 +135,21 @@
       "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."
     }
   ]
 }

package/.grok-plugin/index.json

@@ -145,6 +145,21 @@
       "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."
+    },
+    {
+      "name": "olko:wikipedia-uk-editor",
+      "source": "./packages/software-development/wikipedia-uk-editor/adapters/grok",
+      "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/grok",
+      "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/grok",
+      "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."
     }
   ]
 }

package/.kiro/steering/wikipedia-uk-editor.md

@@ -0,0 +1,105 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+inclusion: manual
+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."
+---
+
+# Ukrainian Wikipedia Editor
+
+Turn a URL or article title into a complete, policy-compliant Ukrainian Wikipedia edit that the human pastes into the wiki editor themselves.
+
+## Hard Rules
+
+1. **Never submit an edit.** No `action=edit`, no logged-in browser automation, no bot password. This skill only reads and drafts. The human pastes and saves. Automated saving without a ВП:БОТ approval risks a block.
+2. **Never invent a source, a date, a number, or a citation.** Every fact added must trace to a source that was actually fetched in this session. If it cannot be sourced, it does not go in the article.
+3. **Never copy-paste prose from a source.** Ukrainian Wikipedia deletes copyright violations (ВП:Авторські права) on sight. Paraphrase in Ukrainian and cite.
+4. **Never translate machine-literally.** A rough MT dump is a deletion candidate. Ukrainian syntax, Ukrainian transliteration of names, Ukrainian date format (`12 березня 2024`), decimal comma.
+5. **Use only template and policy names verified against the live wiki.** See `references/wikitext-uk.md`. If a template is not listed there, verify it exists before using it — the helper script has a `check` command.
+6. **Disclose AI assistance** on the user page and, when substantial, in the edit summary. Undisclosed LLM output is the fastest route to scrutiny.
+
+## Outcome
+
+A single deliverable written to a scratch file and echoed in chat:
+
+- the **target page** (exact ukwiki title, and whether it exists)
+- the **wikitext** — full article, or an exact-replacement section, or a precise before/after diff for small fixes
+- the **edit summary** in Ukrainian (≤ 200 chars)
+- the **source list** with the URL, publisher, and date actually fetched for each
+- **risk notes**: notability (ВП:ЗН) standing, anything a patroller will challenge, what still needs a human check
+
+## Workflow
+
+### 1. Classify the task
+
+| Input | Mode |
+|---|---|
+| en.wikipedia.org URL, no uk equivalent | **Translate** — new uk article |
+| uk.wikipedia.org URL, stub or thin | **Expand** |
+| uk.wikipedia.org URL with `{{Без джерел}}` / `{{Джерело}}` | **Source** |
+| uk.wikipedia.org URL, prose/format problems | **Cleanup** |
+| "what should I edit next" | **Plan** — read `references/strategy.md`, propose a ranked list |
+
+Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft against the wrong title.
+
+### 2. Read before writing
+
+```sh
+./scripts/wiki.sh get uk "Тайтл"          # current wikitext
+./scripts/wiki.sh get en "Title"          # source-language wikitext
+./scripts/wiki.sh langlink en "Title" uk  # does a uk version already exist?
+./scripts/wiki.sh check uk "Шаблон:Особа" # does this template/page exist?
+```
+
+Stop and report if:
+- a uk article already exists for a "new translation" (then it is an **Expand** task, not a new page)
+- the subject fails ВП:ЗН — do not draft an article that will be deleted; say so and propose an alternative target
+
+### 3. Gather real sources
+
+For **Translate**: the English article's own reference list is a source *lead*, not a source. Fetch each reference actually cited for the claims you keep. Drop claims whose sources are dead or paywalled beyond verification. Prefer Ukrainian-language sources where they exist — patrollers weigh them higher.
+
+For **Source/Expand**: search for the specific unsourced claim, not the topic in general. Reject blogs, press releases, user-generated wikis, and the subject's own site for anything contested (ВП:АД).
+
+Record for each source: URL, title, publisher, publication date, access date. These become `{{Cite web}}` / `{{Стаття}}` / `{{Книга}}` parameters — see `references/wikitext-uk.md`.
+
+### 4. Draft the wikitext
+
+Follow `references/wikitext-uk.md` for structure, citation templates, infoboxes, section names, categories, and the `{{Перекладена стаття}}` attribution template that translations legally require.
+
+Scale to the subject: a person gets ~4–8 sourced sentences minimum, not two. Under that, it is a stub — label it `{{Заготовка}}` honestly rather than pretending it is complete.
+
+### 5. Self-check before delivering
+
+Run every item. Report failures rather than hiding them.
+
+- [ ] Every non-obvious factual claim has an inline `<ref>`
+- [ ] No sentence is a translated copy of a copyrighted source
+- [ ] Every template used exists (checked, not assumed)
+- [ ] `{{Перекладена стаття}}` present with the source revision id, if translated
+- [ ] Categories present and non-empty; at least one is a real existing category
+- [ ] Interwiki handled via Wikidata note, not hardcoded links
+- [ ] Neutral tone (ВП:НТЗ) — no promotional adjectives, no unattributed evaluation
+- [ ] No original synthesis (ВП:ОД)
+- [ ] Dates, numbers, and name transliterations are Ukrainian-correct
+- [ ] Edit summary written in Ukrainian and states what changed and why
+
+### 6. Deliver
+
+Write the draft to a scratch file (`.md` alongside the raw `.wiki` text so paste is clean), print the edit summary, and tell the human exactly where to paste it:
+
+- new article → `https://uk.wikipedia.org/wiki/Тайтл?action=edit`
+- section replace → name the section and its exact current heading
+- test first → `Вікіпедія:Пісочниця` or the user's own `Користувач:Ім'я/Чернетка`
+
+Then stop. Do not offer to save it.
+
+## References
+
+- `references/strategy.md` — the contribution strategy: what to farm, in what order, and how to build standing without getting flagged
+- `references/wikitext-uk.md` — verified uk templates, citation formats, article skeletons, policy shortcuts
+- `scripts/wiki.sh` — read-only MediaWiki API helper
+
+## Verification
+
+The skill has done its job when the human can paste the output unchanged, and the resulting edit survives patrolling with no maintenance template added.

package/.windsurf/rules/wikipedia-uk-editor.md

@@ -0,0 +1,104 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+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."
+---
+
+# Ukrainian Wikipedia Editor
+
+Turn a URL or article title into a complete, policy-compliant Ukrainian Wikipedia edit that the human pastes into the wiki editor themselves.
+
+## Hard Rules
+
+1. **Never submit an edit.** No `action=edit`, no logged-in browser automation, no bot password. This skill only reads and drafts. The human pastes and saves. Automated saving without a ВП:БОТ approval risks a block.
+2. **Never invent a source, a date, a number, or a citation.** Every fact added must trace to a source that was actually fetched in this session. If it cannot be sourced, it does not go in the article.
+3. **Never copy-paste prose from a source.** Ukrainian Wikipedia deletes copyright violations (ВП:Авторські права) on sight. Paraphrase in Ukrainian and cite.
+4. **Never translate machine-literally.** A rough MT dump is a deletion candidate. Ukrainian syntax, Ukrainian transliteration of names, Ukrainian date format (`12 березня 2024`), decimal comma.
+5. **Use only template and policy names verified against the live wiki.** See `references/wikitext-uk.md`. If a template is not listed there, verify it exists before using it — the helper script has a `check` command.
+6. **Disclose AI assistance** on the user page and, when substantial, in the edit summary. Undisclosed LLM output is the fastest route to scrutiny.
+
+## Outcome
+
+A single deliverable written to a scratch file and echoed in chat:
+
+- the **target page** (exact ukwiki title, and whether it exists)
+- the **wikitext** — full article, or an exact-replacement section, or a precise before/after diff for small fixes
+- the **edit summary** in Ukrainian (≤ 200 chars)
+- the **source list** with the URL, publisher, and date actually fetched for each
+- **risk notes**: notability (ВП:ЗН) standing, anything a patroller will challenge, what still needs a human check
+
+## Workflow
+
+### 1. Classify the task
+
+| Input | Mode |
+|---|---|
+| en.wikipedia.org URL, no uk equivalent | **Translate** — new uk article |
+| uk.wikipedia.org URL, stub or thin | **Expand** |
+| uk.wikipedia.org URL with `{{Без джерел}}` / `{{Джерело}}` | **Source** |
+| uk.wikipedia.org URL, prose/format problems | **Cleanup** |
+| "what should I edit next" | **Plan** — read `references/strategy.md`, propose a ranked list |
+
+Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft against the wrong title.
+
+### 2. Read before writing
+
+```sh
+./scripts/wiki.sh get uk "Тайтл"          # current wikitext
+./scripts/wiki.sh get en "Title"          # source-language wikitext
+./scripts/wiki.sh langlink en "Title" uk  # does a uk version already exist?
+./scripts/wiki.sh check uk "Шаблон:Особа" # does this template/page exist?
+```
+
+Stop and report if:
+- a uk article already exists for a "new translation" (then it is an **Expand** task, not a new page)
+- the subject fails ВП:ЗН — do not draft an article that will be deleted; say so and propose an alternative target
+
+### 3. Gather real sources
+
+For **Translate**: the English article's own reference list is a source *lead*, not a source. Fetch each reference actually cited for the claims you keep. Drop claims whose sources are dead or paywalled beyond verification. Prefer Ukrainian-language sources where they exist — patrollers weigh them higher.
+
+For **Source/Expand**: search for the specific unsourced claim, not the topic in general. Reject blogs, press releases, user-generated wikis, and the subject's own site for anything contested (ВП:АД).
+
+Record for each source: URL, title, publisher, publication date, access date. These become `{{Cite web}}` / `{{Стаття}}` / `{{Книга}}` parameters — see `references/wikitext-uk.md`.
+
+### 4. Draft the wikitext
+
+Follow `references/wikitext-uk.md` for structure, citation templates, infoboxes, section names, categories, and the `{{Перекладена стаття}}` attribution template that translations legally require.
+
+Scale to the subject: a person gets ~4–8 sourced sentences minimum, not two. Under that, it is a stub — label it `{{Заготовка}}` honestly rather than pretending it is complete.
+
+### 5. Self-check before delivering
+
+Run every item. Report failures rather than hiding them.
+
+- [ ] Every non-obvious factual claim has an inline `<ref>`
+- [ ] No sentence is a translated copy of a copyrighted source
+- [ ] Every template used exists (checked, not assumed)
+- [ ] `{{Перекладена стаття}}` present with the source revision id, if translated
+- [ ] Categories present and non-empty; at least one is a real existing category
+- [ ] Interwiki handled via Wikidata note, not hardcoded links
+- [ ] Neutral tone (ВП:НТЗ) — no promotional adjectives, no unattributed evaluation
+- [ ] No original synthesis (ВП:ОД)
+- [ ] Dates, numbers, and name transliterations are Ukrainian-correct
+- [ ] Edit summary written in Ukrainian and states what changed and why
+
+### 6. Deliver
+
+Write the draft to a scratch file (`.md` alongside the raw `.wiki` text so paste is clean), print the edit summary, and tell the human exactly where to paste it:
+
+- new article → `https://uk.wikipedia.org/wiki/Тайтл?action=edit`
+- section replace → name the section and its exact current heading
+- test first → `Вікіпедія:Пісочниця` or the user's own `Користувач:Ім'я/Чернетка`
+
+Then stop. Do not offer to save it.
+
+## References
+
+- `references/strategy.md` — the contribution strategy: what to farm, in what order, and how to build standing without getting flagged
+- `references/wikitext-uk.md` — verified uk templates, citation formats, article skeletons, policy shortcuts
+- `scripts/wiki.sh` — read-only MediaWiki API helper
+
+## Verification
+
+The skill has done its job when the human can paste the output unchanged, and the resulting edit survives patrolling with no maintenance template added.

package/README.md

@@ -140,7 +140,7 @@ packages/{category}/{skill}/SKILL.md
 
 Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup name in a new agent session.
 
-### Software development (24)
+### Software development (27)
 
 | Skill | What it does | Use when |
 |-------|-------------|----------|
@@ -148,6 +148,7 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
 | [ai-tools-setup](packages/software-development/ai-tools-setup/SKILL.md) | Sets up, repairs, and reports on the RTK + ICM + Vox AI development toolkit — installs missing tools, fixes broken hooks and MCP config | Bootstrapping AI dev tools on a new machine or diagnosing broken integrations |
 | [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 |
+| [ci-fix-loop](packages/software-development/ci-fix-loop/SKILL.md) | Diagnoses GitHub Actions CI failures in a loop: fetches failing check logs, applies a targeted fix, pushes, and waits for the next run — repeating until green or a blocker needs a human | CI is red after a push and you want it driven to green automatically |
 | [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 |
@@ -160,6 +161,7 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
 | [obsidian-task-rollover](packages/software-development/obsidian-task-rollover/SKILL.md) | Migrates unchecked tasks from today's Obsidian daily note to the next workday under `## Carried over` | End-of-day bullet-journal task migration |
 | [open-source-publisher](packages/software-development/open-source-publisher/SKILL.md) | Prepares an open-source repository for public publishing with branding, CI/CD, and release hygiene | Releasing a private project publicly with proper GitHub Pages, README, and social preview |
 | [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 |
+| [pr-description-writer](packages/software-development/pr-description-writer/SKILL.md) | Drafts and posts a GitHub PR title and body from git diff and commit history, respecting existing PR templates | Opening a PR after pushing a branch or wanting a structured PR description written automatically |
 | [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 |
@@ -168,6 +170,7 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
 | [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 |
+| [wikipedia-uk-editor](packages/software-development/wikipedia-uk-editor/SKILL.md) | Drafts policy-compliant Ukrainian Wikipedia edits — en→uk translation, stub expansion, sourcing, backlog cleanup — returning ready-to-paste wikitext, an edit summary, and a verified source list | Editing, translating, or sourcing a uk.wikipedia.org article, or planning what to contribute next |
 
 ### Marketing (2)
 

package/catalog/skills.json

@@ -672,6 +672,76 @@
         "kiro",
         "grok"
       ]
+    },
+    {
+      "name": "wikipedia-uk-editor",
+      "lookupName": "olko:wikipedia-uk-editor",
+      "category": "software-development",
+      "path": "packages/software-development/wikipedia-uk-editor",
+      "description": "Draft policy-compliant Ukrainian Wikipedia edits \u2014 translate an English article into uk, expand or source an existing uk article, or fix a maintenance backlog item \u2014 and return ready-to-paste wikitext plus an edit summary.",
+      "tags": [
+        "wikipedia",
+        "ukrainian",
+        "wikitext",
+        "translation",
+        "sourcing",
+        "editing"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok",
+        "windsurf",
+        "kiro",
+        "hermes",
+        "pi"
+      ]
+    },
+    {
+      "name": "pr-description-writer",
+      "lookupName": "olko:pr-description-writer",
+      "category": "software-development",
+      "path": "packages/software-development/pr-description-writer",
+      "description": "Draft and post a GitHub PR title and body from git diff and commit history. Chains after git-commit and before qodoloop / coderabbitloop.",
+      "tags": [
+        "git",
+        "github",
+        "pull-request",
+        "description",
+        "pr",
+        "workflow"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
+    },
+    {
+      "name": "ci-fix-loop",
+      "lookupName": "olko:ci-fix-loop",
+      "category": "software-development",
+      "path": "packages/software-development/ci-fix-loop",
+      "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.",
+      "tags": [
+        "github-actions",
+        "ci",
+        "testing",
+        "automation",
+        "loop",
+        "fix"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot",
+        "grok"
+      ]
     }
   ]
 }

package/collections/software-development.json

@@ -10,6 +10,7 @@
     "promptctl",
     "open-source-publisher",
     "product-builder",
-    "mvp-oneshot"
+    "mvp-oneshot",
+    "wikipedia-uk-editor"
   ]
 }

package/package.json

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

package/packages/software-development/ci-fix-loop/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: ci-fix-loop
+description: >
+  Diagnose GitHub Actions CI failures in a loop: fetch the failing check logs, identify
+  the root cause, apply a targeted fix, push, and wait for the next run — repeating until
+  all checks are green or a real blocker needs a human. Use when CI is red after a push,
+  when the user says "fix CI", "make tests pass", "diagnose CI failures", or "drive this
+  to green". Direct analog of qodoloop / coderabbitloop for automated test and lint failures.
+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, with a GitHub Actions workflow configured.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - github-actions
+    - ci
+    - testing
+    - automation
+    - loop
+    - fix
+source: weekly-pattern-learner
+source_reason: "qodoloop and coderabbitloop share the push→poll→diagnose→fix→repeat loop; CI failures have the same shape but no dedicated skill existed"
+source_date: "2026-07-28"
+---
+
+> 🤖 *Auto-generated by **weekly-pattern-learner** · qodoloop and coderabbitloop share the push→poll→diagnose→fix→repeat loop; CI failures have the same shape but no dedicated skill existed*
+
+# CI Fix Loop
+
+Drive a GitHub Actions CI run from red to green: fetch failure logs, diagnose, apply
+a targeted fix, push, and repeat until all required checks pass or a blocker is hit.
+
+## Inputs
+
+- **PR number** (optional): detect from current branch if not given.
+- **Check names** (optional): limit to specific failing checks instead of all.
+- **Max iterations** (default: 5)
+
+## Workflow
+
+### 1. Identify the PR and current CI state
+
+```bash
+# Detect PR from current branch
+gh pr view --json number,headRefName,headRefOid \
+  -q '{number, branch: .headRefName, sha: .headRefOid}'
+
+# Current check status
+gh pr checks --json name,state,conclusion 2>/dev/null \
+  || gh run list --branch <branch> --limit 5
+```
+
+Classify each check as: `pass`, `fail`, `pending`, or `skipped`.
+
+**Exit immediately if all required checks already pass** — nothing to do.
+
+### 2. Loop (max 5 iterations)
+
+#### A. Identify failing checks
+
+```bash
+gh pr checks --json name,state,conclusion \
+  --jq '.[] | select(.conclusion == "failure" or .state == "FAILURE")'
+```
+
+For each failing check, record: check name, workflow file, job name.
+
+Stop if the working set is empty — all required checks are green.
+
+#### B. Check for base-branch regression first
+
+Before touching any code, verify the failure is not already present on `main`:
+
+```bash
+gh run list --branch <base-branch> --workflow <workflow-name> --limit 3 \
+  --json conclusion --jq '.[].conclusion'
+```
+
+If the same check is failing on the base branch, **stop and report** —
+this is not your PR's fault. Do not attempt a fix that masks a base-branch problem.
+Wait for a `Base branch recovered` notice before re-trying.
+
+#### C. Fetch failure logs
+
+For each failing check:
+
+```bash
+# Latest run ID for this branch/workflow
+gh run list --branch <branch> --workflow <workflow-name> --limit 1 \
+  --json databaseId --jq '.[0].databaseId'
+
+# Fetch only failing steps (not the full log)
+gh run view <run-id> --log-failed
+```
+
+Cap log reading at ~200 lines per job — the error is almost always in the last
+50 lines of a failed step.
+
+#### D. Diagnose
+
+Classify the failure before writing any code:
+
+| Category | Examples | Fix target |
+|---|---|---|
+| Test failure | `FAIL TestFoo`, `AssertionError`, `expected X got Y` | Source or test |
+| Lint / format | `gofmt`, `eslint`, `ruff`, `prettier` | Run auto-formatter |
+| Build error | compile error, missing import, type mismatch | Source |
+| Dependency | `npm ERR!`, missing module, lockfile mismatch | Update lockfile |
+| CI config | YAML parse error, bad action ref, missing secret | Workflow YAML |
+| Flaky test | same test passes on manual re-run | Re-run first; mark if it keeps failing |
+
+For flaky-looking failures, re-run the check before touching code:
+
+```bash
+gh run rerun <run-id> --failed
+```
+
+Wait for the rerun result. If it passes on rerun, skip this iteration and go to
+step F to poll for the new result.
+
+#### E. Apply a targeted fix
+
+Fix **only** what the log names as the failure. Do not refactor surrounding code,
+add unrelated tests, or touch files the failing step never mentioned.
+
+Common one-liners:
+
+```bash
+# Go format
+gofmt -w .
+goimports -w .
+
+# Node format / lint
+npx prettier --write .
+npx eslint --fix .
+
+# Python
+ruff check --fix .
+black .
+
+# Lockfile
+npm install          # Node
+poetry lock --no-update  # Python
+go mod tidy          # Go
+```
+
+For test failures: read the failing test and the code it exercises. Fix the code
+or the assertion — but not both in one commit unless the test was clearly wrong
+and the fix is trivial.
+
+#### F. Commit and push
+
+Stage **only the files touched in step E** — never `git add -A`, which can sweep
+in unrelated local changes:
+
+```bash
+git add <files touched>
+git commit -m "fix(ci): <what was broken> (ci-fix-loop iteration N)"
+git push
+```
+
+Confirm the push succeeded before polling. A resolved check whose fix never reached
+the branch is worse than an unresolved one.
+
+#### G. Wait for CI on the new SHA
+
+Poll every ~15s (timeout ~8min) for all previously-failing checks to complete
+on the new push:
+
+```bash
+gh pr checks --json name,state,conclusion,startedAt
+```
+
+Wait until all previously-failing checks show a new result (`pass` or `fail`)
+on the current SHA. Do not act on a result that still shows the old SHA.
+
+Go back to step A.
+
+### 3. Report
+
+| Field | Value |
+|---|---|
+| Iterations | N |
+| Checks fixed | names + root cause |
+| Checks blocked | names + reason (flaky / needs human / base-branch red) |
+| Final status | all green / partial / blocked |
+
+```
+CI fix loop complete.
+  Iterations:  2
+  Fixed:       lint (gofmt: 3 files), test (TestUserCreate — nil pointer in fixture)
+  Blocked:     none
+  Status:      all required checks green
+```
+
+## Chaining
+
+| Before this skill | After this skill |
+|---|---|
+| `olko:pr-description-writer` | `olko:qodoloop` |
+| Any `git push` with failing CI | `olko:coderabbitloop` |

package/packages/software-development/ci-fix-loop/adapters/claude/plugin.json

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