@olegkoval/agent-skills 1.21.1 → 1.22.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.21.1",
   "author": {
     "name": "Oleg Koval"
   },
@@ -37,6 +37,7 @@
     "./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"
   ]
 }

package/.cursor-plugin/index.json

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

package/.grok-plugin/index.json

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

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 (25)
 
 | Skill | What it does | Use when |
 |-------|-------------|----------|
@@ -168,6 +168,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,32 @@
         "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"
+      ]
     }
   ]
 }

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.22.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/packages/software-development/wikipedia-uk-editor/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: wikipedia-uk-editor
+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. Use when given a uk.wikipedia.org or en.wikipedia.org URL or article title to edit, translate, source, or improve, or when planning what to contribute to ukwiki next.
+license: MIT
+allowed-tools: Bash, Read, Write, Edit, WebFetch, WebSearch
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Hermes, and other Agent Skills compatible tools. Requires curl and python3 for the read-only MediaWiki API helper.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - wikipedia
+    - ukrainian
+    - wikitext
+    - translation
+    - sourcing
+    - editing
+---
+
+# 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/packages/software-development/wikipedia-uk-editor/adapters/claude/plugin.json

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

package/packages/software-development/wikipedia-uk-editor/adapters/claude/skills/wikipedia-uk-editor/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: wikipedia-uk-editor
+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. Use when given a uk.wikipedia.org or en.wikipedia.org URL or article title to edit, translate, source, or improve, or when planning what to contribute to ukwiki next.
+license: MIT
+allowed-tools: Bash, Read, Write, Edit, WebFetch, WebSearch
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Hermes, and other Agent Skills compatible tools. Requires curl and python3 for the read-only MediaWiki API helper.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - wikipedia
+    - ukrainian
+    - wikitext
+    - translation
+    - sourcing
+    - editing
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# 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.