@olegkoval/agent-skills 1.30.0 → 1.32.0

package/packages/software-development/wikipedia-uk-editor/adapters/windsurf/rules/wikipedia-uk-editor.md

@@ -22,7 +22,7 @@ Turn a URL or article title into a complete, policy-compliant Ukrainian Wikipedi
 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 **wikitext** — always the complete final article in one `.wiki` file, ready to paste over the whole edit box; never a diff, never a БУЛО/СТАЛО list of manual replacements
 - 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
@@ -33,12 +33,15 @@ A single deliverable written to a scratch file and echoed in chat:
 
 | Input | Mode |
 |---|---|
+| explicit newcomer task (tier + type, e.g. "Середні → Оновлювати статті") | mode set by task type — see below |
 | 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 |
 
+When a newcomer task type is given, it **overrides** the state-based guess above. The per-type scope contract in `references/newcomer-tasks.md` is binding — an assigned type is a ceiling on what the edit may touch, not a floor.
+
 Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft against the wrong title.
 
 ### 2. Read before writing
@@ -48,6 +51,7 @@ Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft aga
 ./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?
+./scripts/wiki.sh tasks <type> [n]        # list candidates for a newcomer task type: copyedit|links|references|update|expand
 ```
 
 Stop and report if:
@@ -82,21 +86,38 @@ Run every item. Report failures rather than hiding them.
 - [ ] No original synthesis (ВП:ОД)
 - [ ] Dates, numbers, and name transliterations are Ukrainian-correct
 - [ ] Edit summary written in Ukrainian and states what changed and why
+- [ ] The edit stayed inside the assigned task type's allowed scope
+- [ ] Any maintenance template removed was actually earned — the underlying problem is genuinely fixed
 
 ### 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:
+For Expand / Source / Cleanup: fetch the current wikitext, apply the changes programmatically (a small Python pass over the fetched file, asserting each anchor string matched exactly once), and write the whole resulting article out. Verify it before delivering — section list intact, every intended change landed, nothing else dropped.
+
+Write the draft to a scratch file: the raw `.wiki` file contains nothing but article wikitext (the full final article, ready to paste over the whole edit box); the human-readable explanation of what changed goes in a separate `.md`. 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
+- existing article → `https://uk.wikipedia.org/w/index.php?title=Тайтл&action=edit`, replace the whole edit box
 - test first → `Вікіпедія:Пісочниця` or the user's own `Користувач:Ім'я/Чернетка`
 
+End the delivery with a copy-to-clipboard command in its own fenced block, using a quoted absolute path — quoted because scratchpad paths contain characters the shell will otherwise mangle — always the raw `.wiki` file, never the `.md`:
+
+```sh
+pbcopy < "/absolute/path/to/slug.wiki"
+```
+
+Add an optional second line when the edit summary is long enough to be worth copying:
+
+```sh
+printf '%s' 'Опис редагування…' | pbcopy
+```
+
 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
+- `references/newcomer-tasks.md` — the newcomer task tiers (Легкі/Середні/Важкі) and the binding scope contract for each task type
 - `scripts/wiki.sh` — read-only MediaWiki API helper
 
 ## Verification

package/packages/software-development/wikipedia-uk-editor/references/newcomer-tasks.md

@@ -0,0 +1,80 @@
+# Ukrainian Wikipedia newcomer task types
+
+Verified against the live `uk.wikipedia.org` API, 2026-08-20.
+
+`MediaWiki:NewcomerTasks.json` is the authoritative GrowthExperiments "Suggested edits"
+(Пропоновані редагування) task-type → maintenance-template map on ukwiki. The table below is
+that map.
+
+## Task-type mapping
+
+| ukwiki UI label | Tier | task type | Backing template(s) |
+|---|---|---|---|
+| Вичитувати | Легкі / easy | `copyedit` | `Шаблон:Мовні помилки` |
+| (not offered in UI — structured) | easy | `link-recommendation` | none |
+| (not offered in that UI list) | easy | `links` | `Шаблон:Упорядкувати`, `Шаблон:Брак посилань` |
+| Шукати зовнішні посилання | Середні / medium | `references` | `Шаблон:Без джерел` |
+| Оновлювати статті | Середні / medium | `update` | `Шаблон:Оновити` |
+| (not offered — structured) | medium | `image-recommendation`, `section-image-recommendation` | none |
+| Розширювати короткі статті | Важкі / hard | `expand` | `Шаблон:Доробити` |
+
+All six templates confirmed EXISTS. `Шаблон:Доробити` is a REDIRECT to `Шаблон:Заготовка`
+(see `references/wikitext-uk.md`).
+
+## Scope contract per task type
+
+An assigned task type is a **ceiling**, not a suggestion — overreach on a young account is what
+draws patrollers (see `references/strategy.md` Phase 1). Stay inside the type you picked.
+
+### `copyedit` — Вичитувати
+
+- IS: language, grammar, punctuation, typography fixes only.
+- NOT: no new facts, no new refs, no restructuring, no adding/removing/reordering sections.
+- Remove `{{Мовні помилки}}` in the same edit only if the whole article was actually proofread.
+- Edit summary shape: `Вичитка: виправлено [конкретні помилки]`.
+
+### `links` — Упорядкувати / Брак посилань
+
+- IS: wikilinks and formatting only.
+- NOT: no prose rewriting.
+- Edit summary shape: `Впорядкування посилань: [що додано/виправлено]`.
+
+### `references` — Шукати зовнішні посилання
+
+- IS: add inline `<ref>` to claims that are **already there**.
+- NOT: never rewrite a claim to fit a source you happened to find. If no source supports it as
+  written, report it — do not reshape it.
+- Remove `{{Без джерел}}` only when every substantive claim is cited.
+- Edit summary shape: `Додано джерела: [що саме підтверджено]`.
+
+### `update` — Оновлювати статті
+
+- IS: replace outdated values/dates/status with sourced current ones, plus the minimum prose the
+  change forces.
+- NOT: no scope expansion, no new sections.
+- Every updated number needs a source actually fetched this session — this is the highest
+  fabrication-risk type in the set and SKILL.md Hard Rule 2 applies with no exceptions.
+- Edit summary shape: `Оновлено дані: [що змінено] за станом на [дата]`.
+
+### `expand` — Розширювати короткі статті
+
+- IS: the **only** type permitted to add sections and substantial new sourced prose. Routes into
+  the existing **Expand** mode in SKILL.md.
+- `{{Заготовка}}` comes off only when the article genuinely stops being a stub.
+- Edit summary shape: `Розширено статтю: додано [розділи/теми], джерела`.
+
+## Out of scope: structured task types
+
+`link-recommendation`, `image-recommendation`, and `section-image-recommendation` are served
+through the Growth UI's own accept/reject widget on ukwiki, not by pasting wikitext. This skill
+does not improvise a manual equivalent for them — say so plainly and decline rather than draft
+around it.
+
+## Finding candidates
+
+`action=query&list=growthtasks` requires login, so this read-only skill cannot use it. Find
+candidate articles for a task type instead with:
+
+```sh
+./scripts/wiki.sh tasks <type> [n]
+```

package/packages/software-development/wikipedia-uk-editor/references/strategy.md

@@ -31,6 +31,16 @@ Rules for this phase: one change per edit, always an edit summary in Ukrainian,
 
 Target: ~30–50 edits, **zero reverts**. A revert in this phase costs more than 50 edits gain.
 
+### Newcomer tasks as a ready-made Phase 1 queue
+
+Ukrainian Wikipedia's own GrowthExperiments "Suggested edits" (Пропоновані редагування) tiers a
+maintenance backlog into Легкі / Середні / Важкі — see `references/newcomer-tasks.md` for the
+full mapping and per-type scope contract. Легкі (`copyedit`) and Середні (`references`, `update`)
+are lower-risk, community-endorsed work for this phase, but they are not zero-revert-risk:
+sourcing and fabrication risks still require verification. Pick candidates
+with `./scripts/wiki.sh tasks <type>` and stay strictly inside the assigned scope. Важкі
+(`expand`) is not Phase 1 work — it belongs in Phase 2 stream A/B, once autoconfirmed.
+
 ## Phase 2 — the volume engine (weeks 2–8)
 
 Four streams, run in parallel, roughly in this priority order. Value per unit of effort, highest first:

package/packages/software-development/wikipedia-uk-editor/scripts/wiki.sh

@@ -10,6 +10,7 @@
 #   wiki.sh search   <lang> <query> [n]      search article titles
 #   wiki.sh backlog  <category> [n]          list pages in a uk category (maintenance backlogs)
 #   wiki.sh info     <lang> <title>          length, last edit, categories, templates used
+#   wiki.sh tasks    <type> [n]              candidate articles for a newcomer task type
 set -eu
 
 UA="wikipedia-uk-editor-skill/1.0 (https://github.com/oleg-koval/agent-skills)"
@@ -24,7 +25,7 @@ api() {
 jqp() { python3 -c "$1"; }
 
 cmd=${1:-}
-[ -n "$cmd" ] || { sed -n '2,14p' "$0"; exit 1; }
+[ -n "$cmd" ] || { sed -n '2,13p' "$0"; exit 1; }
 shift
 
 case "$cmd" in
@@ -92,7 +93,62 @@ print('touched:',p.get('touched'))
 print('cats   :', ', '.join(c['title'] for c in p.get('categories',[])) or '(none)')
 print('tmpls  :', ', '.join(t['title'] for t in p.get('templates',[])) or '(none)')"
     ;;
+  tasks)
+    type=${1:-}
+    n=${2:-20}
+    case "$n" in
+      ''|*[!0-9]*) echo "Invalid task limit: '$n' (expected a non-negative integer)" >&2; exit 1 ;;
+    esac
+    case "$type" in
+      copyedit)   templates="Шаблон:Мовні помилки" ;;
+      links)      templates="Шаблон:Упорядкувати|Шаблон:Брак посилань" ;;
+      references) templates="Шаблон:Без джерел" ;;
+      update)     templates="Шаблон:Оновити" ;;
+      expand)     templates="Шаблон:Доробити" ;;
+      *)
+        echo "Unknown task type: '$type'. Valid types: copyedit, links, references, update, expand" >&2
+        exit 1
+        ;;
+    esac
+    [ "$n" -gt 0 ] || exit 0
+    results=$(mktemp)
+    trap 'rm -f "$results"' EXIT
+    oldifs=$IFS
+    IFS='|'
+    for tmpl in $templates; do
+      IFS=$oldifs
+      api uk --data-urlencode "action=query" --data-urlencode "list=embeddedin" \
+          --data-urlencode "eititle=$tmpl" --data-urlencode "einamespace=0" \
+          --data-urlencode "eilimit=$n" |
+        jqp "import json,sys
+d=json.load(sys.stdin)
+if 'error' in d: sys.exit('NOT FOUND: '+d['error'].get('info',''))
+for m in d['query']['embeddedin']: print(m['title'])" |
+        while IFS= read -r title; do printf '%s\t%s\n' "$tmpl" "$title"; done >> "$results"
+    done
+    python3 - "$results" "$n" <<'PY'
+import sys
+from collections import OrderedDict
+
+path, limit_text = sys.argv[1:]
+limit = int(limit_text)
+groups = OrderedDict()
+seen = set()
+with open(path, encoding="utf-8") as handle:
+    for line in handle:
+        template, title = line.rstrip("\n").split("\t", 1)
+        if title in seen:
+            continue
+        seen.add(title)
+        groups.setdefault(template, []).append(title)
+        if len(seen) == limit:
+            break
+for template, titles in groups.items():
+    print(f"== {template} ==")
+    print("\n".join(titles))
+PY
+    ;;
   *)
-    sed -n '2,14p' "$0"; exit 1
+    sed -n '2,13p' "$0"; exit 1
     ;;
 esac