@olegkoval/agent-skills 1.21.0 → 1.22.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +6 -2
- package/.cursor-plugin/index.json +20 -0
- package/.grok-plugin/index.json +20 -0
- package/.kiro/steering/add-to-my-skills.md +1 -2
- package/.kiro/steering/ai-tools-setup.md +1 -2
- package/.kiro/steering/changelog-generator.md +1 -2
- package/.kiro/steering/wikipedia-uk-editor.md +105 -0
- package/.windsurf/rules/add-to-my-skills.md +1 -2
- package/.windsurf/rules/ai-tools-setup.md +1 -2
- package/.windsurf/rules/changelog-generator.md +1 -2
- package/.windsurf/rules/wikipedia-uk-editor.md +104 -0
- package/README.md +5 -2
- package/catalog/skills.json +94 -0
- package/collections/software-development.json +2 -1
- package/package.json +1 -1
- package/packages/software-development/add-to-my-skills/adapters/claude/plugin.json +1 -1
- package/packages/software-development/add-to-my-skills/adapters/cursor/plugin.json +1 -1
- package/packages/software-development/add-to-my-skills/adapters/cursor/skills/add-to-my-skills/SKILL.md +1 -1
- package/packages/software-development/add-to-my-skills/adapters/grok/plugin.json +6 -0
- package/packages/software-development/add-to-my-skills/adapters/grok/skills/add-to-my-skills/SKILL.md +89 -0
- package/packages/software-development/add-to-my-skills/adapters/kiro/steering/add-to-my-skills.md +1 -1
- package/packages/software-development/add-to-my-skills/adapters/windsurf/rules/add-to-my-skills.md +1 -1
- package/packages/software-development/ai-tools-setup/adapters/claude/plugin.json +1 -1
- package/packages/software-development/ai-tools-setup/adapters/cursor/plugin.json +1 -1
- package/packages/software-development/ai-tools-setup/adapters/cursor/skills/ai-tools-setup/SKILL.md +1 -1
- package/packages/software-development/ai-tools-setup/adapters/grok/plugin.json +6 -0
- package/packages/software-development/ai-tools-setup/adapters/grok/skills/ai-tools-setup/SKILL.md +276 -0
- package/packages/software-development/ai-tools-setup/adapters/kiro/steering/ai-tools-setup.md +1 -1
- package/packages/software-development/ai-tools-setup/adapters/windsurf/rules/ai-tools-setup.md +1 -1
- package/packages/software-development/changelog-generator/adapters/claude/plugin.json +1 -1
- package/packages/software-development/changelog-generator/adapters/cursor/plugin.json +1 -1
- package/packages/software-development/changelog-generator/adapters/cursor/skills/changelog-generator/SKILL.md +1 -1
- package/packages/software-development/changelog-generator/adapters/grok/plugin.json +6 -0
- package/packages/software-development/changelog-generator/adapters/grok/skills/changelog-generator/SKILL.md +115 -0
- package/packages/software-development/changelog-generator/adapters/kiro/steering/changelog-generator.md +1 -1
- package/packages/software-development/changelog-generator/adapters/windsurf/rules/changelog-generator.md +1 -1
- package/packages/software-development/wikipedia-uk-editor/SKILL.md +116 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/claude/plugin.json +5 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/claude/skills/wikipedia-uk-editor/SKILL.md +117 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/claude/skills/wikipedia-uk-editor/references/strategy.md +97 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/claude/skills/wikipedia-uk-editor/references/wikitext-uk.md +121 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/claude/skills/wikipedia-uk-editor/scripts/wiki.sh +98 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/codex/README.md +20 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/cursor/plugin.json +6 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/cursor/skills/wikipedia-uk-editor/SKILL.md +117 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/cursor/skills/wikipedia-uk-editor/references/strategy.md +97 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/cursor/skills/wikipedia-uk-editor/references/wikitext-uk.md +121 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/cursor/skills/wikipedia-uk-editor/scripts/wiki.sh +98 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/grok/plugin.json +6 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/grok/skills/wikipedia-uk-editor/SKILL.md +117 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/grok/skills/wikipedia-uk-editor/references/strategy.md +97 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/grok/skills/wikipedia-uk-editor/references/wikitext-uk.md +121 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/grok/skills/wikipedia-uk-editor/scripts/wiki.sh +98 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/hermes/README.md +3 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/kiro/steering/wikipedia-uk-editor.md +105 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/pi/README.md +3 -0
- package/packages/software-development/wikipedia-uk-editor/adapters/windsurf/rules/wikipedia-uk-editor.md +104 -0
- package/packages/software-development/wikipedia-uk-editor/references/strategy.md +97 -0
- package/packages/software-development/wikipedia-uk-editor/references/wikitext-uk.md +121 -0
- package/packages/software-development/wikipedia-uk-editor/scripts/wiki.sh +98 -0
- package/scripts/validate-catalog.sh +38 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "olko-agent-skills",
|
|
3
3
|
"description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.21.1",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Oleg Koval"
|
|
7
7
|
},
|
|
@@ -34,6 +34,10 @@
|
|
|
34
34
|
"./packages/software-development/crash-course",
|
|
35
35
|
"./packages/software-development/qodoloop",
|
|
36
36
|
"./packages/wearables/garmin-watchface",
|
|
37
|
-
"./packages/software-development/coderabbitloop"
|
|
37
|
+
"./packages/software-development/coderabbitloop",
|
|
38
|
+
"./packages/software-development/add-to-my-skills",
|
|
39
|
+
"./packages/software-development/ai-tools-setup",
|
|
40
|
+
"./packages/software-development/changelog-generator",
|
|
41
|
+
"./packages/software-development/wikipedia-uk-editor"
|
|
38
42
|
]
|
|
39
43
|
}
|
|
@@ -120,6 +120,26 @@
|
|
|
120
120
|
"name": "olko:coderabbitloop",
|
|
121
121
|
"source": "./packages/software-development/coderabbitloop/adapters/cursor",
|
|
122
122
|
"description": "Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings — reads each inline comment's own Prompt for AI Agents block, applies the fix, replies to the thread, resolves it, pushes, and re-triggers CodeRabbit."
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"name": "olko:add-to-my-skills",
|
|
126
|
+
"source": "./packages/software-development/add-to-my-skills/adapters/cursor",
|
|
127
|
+
"description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"name": "olko:ai-tools-setup",
|
|
131
|
+
"source": "./packages/software-development/ai-tools-setup/adapters/cursor",
|
|
132
|
+
"description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"name": "olko:changelog-generator",
|
|
136
|
+
"source": "./packages/software-development/changelog-generator/adapters/cursor",
|
|
137
|
+
"description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"name": "olko:wikipedia-uk-editor",
|
|
141
|
+
"source": "./packages/software-development/wikipedia-uk-editor/adapters/cursor",
|
|
142
|
+
"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."
|
|
123
143
|
}
|
|
124
144
|
]
|
|
125
145
|
}
|
package/.grok-plugin/index.json
CHANGED
|
@@ -130,6 +130,26 @@
|
|
|
130
130
|
"name": "olko:coderabbitloop",
|
|
131
131
|
"source": "./packages/software-development/coderabbitloop/adapters/grok",
|
|
132
132
|
"description": "Iteratively drives a GitHub PR to zero unresolved CodeRabbit findings — reads each inline comment's own Prompt for AI Agents block, applies the fix, replies to the thread, resolves it, pushes, and re-triggers CodeRabbit."
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"name": "olko:add-to-my-skills",
|
|
136
|
+
"source": "./packages/software-development/add-to-my-skills/adapters/grok",
|
|
137
|
+
"description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"name": "olko:ai-tools-setup",
|
|
141
|
+
"source": "./packages/software-development/ai-tools-setup/adapters/grok",
|
|
142
|
+
"description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
"name": "olko:changelog-generator",
|
|
146
|
+
"source": "./packages/software-development/changelog-generator/adapters/grok",
|
|
147
|
+
"description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
"name": "olko:wikipedia-uk-editor",
|
|
151
|
+
"source": "./packages/software-development/wikipedia-uk-editor/adapters/grok",
|
|
152
|
+
"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."
|
|
133
153
|
}
|
|
134
154
|
]
|
|
135
155
|
}
|
|
@@ -2,10 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
---
|
|
4
4
|
inclusion: manual
|
|
5
|
-
description: "Copy a newly created skill into this catalog, refresh manifests,
|
|
5
|
+
description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
|
|
9
8
|
# Add to My Skills
|
|
10
9
|
|
|
11
10
|
Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.
|
|
@@ -2,10 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
---
|
|
4
4
|
inclusion: manual
|
|
5
|
-
description: "
|
|
5
|
+
description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
|
|
9
8
|
# AI Tools Setup — RTK + ICM + Vox
|
|
10
9
|
|
|
11
10
|
Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.
|
|
@@ -2,10 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
---
|
|
4
4
|
inclusion: manual
|
|
5
|
-
description: "
|
|
5
|
+
description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
|
|
9
8
|
# Changelog Generator
|
|
10
9
|
|
|
11
10
|
This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
inclusion: manual
|
|
5
|
+
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."
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Ukrainian Wikipedia Editor
|
|
9
|
+
|
|
10
|
+
Turn a URL or article title into a complete, policy-compliant Ukrainian Wikipedia edit that the human pastes into the wiki editor themselves.
|
|
11
|
+
|
|
12
|
+
## Hard Rules
|
|
13
|
+
|
|
14
|
+
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.
|
|
15
|
+
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.
|
|
16
|
+
3. **Never copy-paste prose from a source.** Ukrainian Wikipedia deletes copyright violations (ВП:Авторські права) on sight. Paraphrase in Ukrainian and cite.
|
|
17
|
+
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.
|
|
18
|
+
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.
|
|
19
|
+
6. **Disclose AI assistance** on the user page and, when substantial, in the edit summary. Undisclosed LLM output is the fastest route to scrutiny.
|
|
20
|
+
|
|
21
|
+
## Outcome
|
|
22
|
+
|
|
23
|
+
A single deliverable written to a scratch file and echoed in chat:
|
|
24
|
+
|
|
25
|
+
- the **target page** (exact ukwiki title, and whether it exists)
|
|
26
|
+
- the **wikitext** — full article, or an exact-replacement section, or a precise before/after diff for small fixes
|
|
27
|
+
- the **edit summary** in Ukrainian (≤ 200 chars)
|
|
28
|
+
- the **source list** with the URL, publisher, and date actually fetched for each
|
|
29
|
+
- **risk notes**: notability (ВП:ЗН) standing, anything a patroller will challenge, what still needs a human check
|
|
30
|
+
|
|
31
|
+
## Workflow
|
|
32
|
+
|
|
33
|
+
### 1. Classify the task
|
|
34
|
+
|
|
35
|
+
| Input | Mode |
|
|
36
|
+
|---|---|
|
|
37
|
+
| en.wikipedia.org URL, no uk equivalent | **Translate** — new uk article |
|
|
38
|
+
| uk.wikipedia.org URL, stub or thin | **Expand** |
|
|
39
|
+
| uk.wikipedia.org URL with `{{Без джерел}}` / `{{Джерело}}` | **Source** |
|
|
40
|
+
| uk.wikipedia.org URL, prose/format problems | **Cleanup** |
|
|
41
|
+
| "what should I edit next" | **Plan** — read `references/strategy.md`, propose a ranked list |
|
|
42
|
+
|
|
43
|
+
Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft against the wrong title.
|
|
44
|
+
|
|
45
|
+
### 2. Read before writing
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
./scripts/wiki.sh get uk "Тайтл" # current wikitext
|
|
49
|
+
./scripts/wiki.sh get en "Title" # source-language wikitext
|
|
50
|
+
./scripts/wiki.sh langlink en "Title" uk # does a uk version already exist?
|
|
51
|
+
./scripts/wiki.sh check uk "Шаблон:Особа" # does this template/page exist?
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Stop and report if:
|
|
55
|
+
- a uk article already exists for a "new translation" (then it is an **Expand** task, not a new page)
|
|
56
|
+
- the subject fails ВП:ЗН — do not draft an article that will be deleted; say so and propose an alternative target
|
|
57
|
+
|
|
58
|
+
### 3. Gather real sources
|
|
59
|
+
|
|
60
|
+
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.
|
|
61
|
+
|
|
62
|
+
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 (ВП:АД).
|
|
63
|
+
|
|
64
|
+
Record for each source: URL, title, publisher, publication date, access date. These become `{{Cite web}}` / `{{Стаття}}` / `{{Книга}}` parameters — see `references/wikitext-uk.md`.
|
|
65
|
+
|
|
66
|
+
### 4. Draft the wikitext
|
|
67
|
+
|
|
68
|
+
Follow `references/wikitext-uk.md` for structure, citation templates, infoboxes, section names, categories, and the `{{Перекладена стаття}}` attribution template that translations legally require.
|
|
69
|
+
|
|
70
|
+
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.
|
|
71
|
+
|
|
72
|
+
### 5. Self-check before delivering
|
|
73
|
+
|
|
74
|
+
Run every item. Report failures rather than hiding them.
|
|
75
|
+
|
|
76
|
+
- [ ] Every non-obvious factual claim has an inline `<ref>`
|
|
77
|
+
- [ ] No sentence is a translated copy of a copyrighted source
|
|
78
|
+
- [ ] Every template used exists (checked, not assumed)
|
|
79
|
+
- [ ] `{{Перекладена стаття}}` present with the source revision id, if translated
|
|
80
|
+
- [ ] Categories present and non-empty; at least one is a real existing category
|
|
81
|
+
- [ ] Interwiki handled via Wikidata note, not hardcoded links
|
|
82
|
+
- [ ] Neutral tone (ВП:НТЗ) — no promotional adjectives, no unattributed evaluation
|
|
83
|
+
- [ ] No original synthesis (ВП:ОД)
|
|
84
|
+
- [ ] Dates, numbers, and name transliterations are Ukrainian-correct
|
|
85
|
+
- [ ] Edit summary written in Ukrainian and states what changed and why
|
|
86
|
+
|
|
87
|
+
### 6. Deliver
|
|
88
|
+
|
|
89
|
+
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:
|
|
90
|
+
|
|
91
|
+
- new article → `https://uk.wikipedia.org/wiki/Тайтл?action=edit`
|
|
92
|
+
- section replace → name the section and its exact current heading
|
|
93
|
+
- test first → `Вікіпедія:Пісочниця` or the user's own `Користувач:Ім'я/Чернетка`
|
|
94
|
+
|
|
95
|
+
Then stop. Do not offer to save it.
|
|
96
|
+
|
|
97
|
+
## References
|
|
98
|
+
|
|
99
|
+
- `references/strategy.md` — the contribution strategy: what to farm, in what order, and how to build standing without getting flagged
|
|
100
|
+
- `references/wikitext-uk.md` — verified uk templates, citation formats, article skeletons, policy shortcuts
|
|
101
|
+
- `scripts/wiki.sh` — read-only MediaWiki API helper
|
|
102
|
+
|
|
103
|
+
## Verification
|
|
104
|
+
|
|
105
|
+
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.
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
2
2
|
|
|
3
3
|
---
|
|
4
|
-
description: "Copy a newly created skill into this catalog, refresh manifests,
|
|
4
|
+
description: "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
# Add to My Skills
|
|
9
8
|
|
|
10
9
|
Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
2
2
|
|
|
3
3
|
---
|
|
4
|
-
description: "
|
|
4
|
+
description: "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
# AI Tools Setup — RTK + ICM + Vox
|
|
9
8
|
|
|
10
9
|
Install, repair, and measure the RTK+ICM+Vox toolkit for Claude Code.
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
2
2
|
|
|
3
3
|
---
|
|
4
|
-
description: "
|
|
4
|
+
description: "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
# Changelog Generator
|
|
9
8
|
|
|
10
9
|
This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
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."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Ukrainian Wikipedia Editor
|
|
8
|
+
|
|
9
|
+
Turn a URL or article title into a complete, policy-compliant Ukrainian Wikipedia edit that the human pastes into the wiki editor themselves.
|
|
10
|
+
|
|
11
|
+
## Hard Rules
|
|
12
|
+
|
|
13
|
+
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.
|
|
14
|
+
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.
|
|
15
|
+
3. **Never copy-paste prose from a source.** Ukrainian Wikipedia deletes copyright violations (ВП:Авторські права) on sight. Paraphrase in Ukrainian and cite.
|
|
16
|
+
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.
|
|
17
|
+
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.
|
|
18
|
+
6. **Disclose AI assistance** on the user page and, when substantial, in the edit summary. Undisclosed LLM output is the fastest route to scrutiny.
|
|
19
|
+
|
|
20
|
+
## Outcome
|
|
21
|
+
|
|
22
|
+
A single deliverable written to a scratch file and echoed in chat:
|
|
23
|
+
|
|
24
|
+
- the **target page** (exact ukwiki title, and whether it exists)
|
|
25
|
+
- the **wikitext** — full article, or an exact-replacement section, or a precise before/after diff for small fixes
|
|
26
|
+
- the **edit summary** in Ukrainian (≤ 200 chars)
|
|
27
|
+
- the **source list** with the URL, publisher, and date actually fetched for each
|
|
28
|
+
- **risk notes**: notability (ВП:ЗН) standing, anything a patroller will challenge, what still needs a human check
|
|
29
|
+
|
|
30
|
+
## Workflow
|
|
31
|
+
|
|
32
|
+
### 1. Classify the task
|
|
33
|
+
|
|
34
|
+
| Input | Mode |
|
|
35
|
+
|---|---|
|
|
36
|
+
| en.wikipedia.org URL, no uk equivalent | **Translate** — new uk article |
|
|
37
|
+
| uk.wikipedia.org URL, stub or thin | **Expand** |
|
|
38
|
+
| uk.wikipedia.org URL with `{{Без джерел}}` / `{{Джерело}}` | **Source** |
|
|
39
|
+
| uk.wikipedia.org URL, prose/format problems | **Cleanup** |
|
|
40
|
+
| "what should I edit next" | **Plan** — read `references/strategy.md`, propose a ranked list |
|
|
41
|
+
|
|
42
|
+
Resolve the title first — `scripts/wiki.sh` handles redirects. Never draft against the wrong title.
|
|
43
|
+
|
|
44
|
+
### 2. Read before writing
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
./scripts/wiki.sh get uk "Тайтл" # current wikitext
|
|
48
|
+
./scripts/wiki.sh get en "Title" # source-language wikitext
|
|
49
|
+
./scripts/wiki.sh langlink en "Title" uk # does a uk version already exist?
|
|
50
|
+
./scripts/wiki.sh check uk "Шаблон:Особа" # does this template/page exist?
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Stop and report if:
|
|
54
|
+
- a uk article already exists for a "new translation" (then it is an **Expand** task, not a new page)
|
|
55
|
+
- the subject fails ВП:ЗН — do not draft an article that will be deleted; say so and propose an alternative target
|
|
56
|
+
|
|
57
|
+
### 3. Gather real sources
|
|
58
|
+
|
|
59
|
+
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.
|
|
60
|
+
|
|
61
|
+
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 (ВП:АД).
|
|
62
|
+
|
|
63
|
+
Record for each source: URL, title, publisher, publication date, access date. These become `{{Cite web}}` / `{{Стаття}}` / `{{Книга}}` parameters — see `references/wikitext-uk.md`.
|
|
64
|
+
|
|
65
|
+
### 4. Draft the wikitext
|
|
66
|
+
|
|
67
|
+
Follow `references/wikitext-uk.md` for structure, citation templates, infoboxes, section names, categories, and the `{{Перекладена стаття}}` attribution template that translations legally require.
|
|
68
|
+
|
|
69
|
+
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.
|
|
70
|
+
|
|
71
|
+
### 5. Self-check before delivering
|
|
72
|
+
|
|
73
|
+
Run every item. Report failures rather than hiding them.
|
|
74
|
+
|
|
75
|
+
- [ ] Every non-obvious factual claim has an inline `<ref>`
|
|
76
|
+
- [ ] No sentence is a translated copy of a copyrighted source
|
|
77
|
+
- [ ] Every template used exists (checked, not assumed)
|
|
78
|
+
- [ ] `{{Перекладена стаття}}` present with the source revision id, if translated
|
|
79
|
+
- [ ] Categories present and non-empty; at least one is a real existing category
|
|
80
|
+
- [ ] Interwiki handled via Wikidata note, not hardcoded links
|
|
81
|
+
- [ ] Neutral tone (ВП:НТЗ) — no promotional adjectives, no unattributed evaluation
|
|
82
|
+
- [ ] No original synthesis (ВП:ОД)
|
|
83
|
+
- [ ] Dates, numbers, and name transliterations are Ukrainian-correct
|
|
84
|
+
- [ ] Edit summary written in Ukrainian and states what changed and why
|
|
85
|
+
|
|
86
|
+
### 6. Deliver
|
|
87
|
+
|
|
88
|
+
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:
|
|
89
|
+
|
|
90
|
+
- new article → `https://uk.wikipedia.org/wiki/Тайтл?action=edit`
|
|
91
|
+
- section replace → name the section and its exact current heading
|
|
92
|
+
- test first → `Вікіпедія:Пісочниця` or the user's own `Користувач:Ім'я/Чернетка`
|
|
93
|
+
|
|
94
|
+
Then stop. Do not offer to save it.
|
|
95
|
+
|
|
96
|
+
## References
|
|
97
|
+
|
|
98
|
+
- `references/strategy.md` — the contribution strategy: what to farm, in what order, and how to build standing without getting flagged
|
|
99
|
+
- `references/wikitext-uk.md` — verified uk templates, citation formats, article skeletons, policy shortcuts
|
|
100
|
+
- `scripts/wiki.sh` — read-only MediaWiki API helper
|
|
101
|
+
|
|
102
|
+
## Verification
|
|
103
|
+
|
|
104
|
+
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
CHANGED
|
@@ -136,11 +136,11 @@ packages/{category}/{skill}/SKILL.md
|
|
|
136
136
|
|
|
137
137
|
</details>
|
|
138
138
|
|
|
139
|
-
## All
|
|
139
|
+
## All 29 Skills
|
|
140
140
|
|
|
141
141
|
Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup name in a new agent session.
|
|
142
142
|
|
|
143
|
-
### Software development (
|
|
143
|
+
### Software development (25)
|
|
144
144
|
|
|
145
145
|
| Skill | What it does | Use when |
|
|
146
146
|
|-------|-------------|----------|
|
|
@@ -162,10 +162,13 @@ Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup n
|
|
|
162
162
|
| [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 |
|
|
163
163
|
| [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 |
|
|
164
164
|
| [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 |
|
|
165
|
+
| [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 |
|
|
165
166
|
| [review-past-performance](packages/software-development/review-past-performance/SKILL.md) | Pulls 24h of ICM memories, git history, and skill analytics; detects repeated mistakes and slow workflows; proposes 1-3 concrete fixes | Daily self-improvement loop or codifying a repeated workflow |
|
|
167
|
+
| [self-critique](packages/software-development/self-critique/SKILL.md) | Adversarially critiques your own last answer: spawns a critic agent that verifies claims against live sources, then loops until satisfied and reports where you were wrong | Checking a substantial answer before the user has to |
|
|
166
168
|
| [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 |
|
|
167
169
|
| [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 |
|
|
168
170
|
| [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 |
|
|
171
|
+
| [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 |
|
|
169
172
|
|
|
170
173
|
### Marketing (2)
|
|
171
174
|
|
package/catalog/skills.json
CHANGED
|
@@ -604,6 +604,100 @@
|
|
|
604
604
|
"windsurf",
|
|
605
605
|
"kiro"
|
|
606
606
|
]
|
|
607
|
+
},
|
|
608
|
+
{
|
|
609
|
+
"name": "add-to-my-skills",
|
|
610
|
+
"lookupName": "olko:add-to-my-skills",
|
|
611
|
+
"category": "software-development",
|
|
612
|
+
"path": "packages/software-development/add-to-my-skills",
|
|
613
|
+
"description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
|
|
614
|
+
"tags": [
|
|
615
|
+
"skills",
|
|
616
|
+
"catalog",
|
|
617
|
+
"automation",
|
|
618
|
+
"git",
|
|
619
|
+
"maintenance"
|
|
620
|
+
],
|
|
621
|
+
"adapters": [
|
|
622
|
+
"codex",
|
|
623
|
+
"claude",
|
|
624
|
+
"cursor",
|
|
625
|
+
"copilot",
|
|
626
|
+
"windsurf",
|
|
627
|
+
"kiro",
|
|
628
|
+
"grok"
|
|
629
|
+
]
|
|
630
|
+
},
|
|
631
|
+
{
|
|
632
|
+
"name": "ai-tools-setup",
|
|
633
|
+
"lookupName": "olko:ai-tools-setup",
|
|
634
|
+
"category": "software-development",
|
|
635
|
+
"path": "packages/software-development/ai-tools-setup",
|
|
636
|
+
"description": "Set up, repair, and report on the RTK+ICM+Vox AI development toolkit, including hooks and MCP configuration.",
|
|
637
|
+
"tags": [
|
|
638
|
+
"setup",
|
|
639
|
+
"tooling",
|
|
640
|
+
"mcp",
|
|
641
|
+
"hooks",
|
|
642
|
+
"developer-experience"
|
|
643
|
+
],
|
|
644
|
+
"adapters": [
|
|
645
|
+
"codex",
|
|
646
|
+
"claude",
|
|
647
|
+
"cursor",
|
|
648
|
+
"copilot",
|
|
649
|
+
"windsurf",
|
|
650
|
+
"kiro",
|
|
651
|
+
"grok"
|
|
652
|
+
]
|
|
653
|
+
},
|
|
654
|
+
{
|
|
655
|
+
"name": "changelog-generator",
|
|
656
|
+
"lookupName": "olko:changelog-generator",
|
|
657
|
+
"category": "software-development",
|
|
658
|
+
"path": "packages/software-development/changelog-generator",
|
|
659
|
+
"description": "Create user-facing changelogs from git history by categorising commits and rewriting them for readers rather than developers.",
|
|
660
|
+
"tags": [
|
|
661
|
+
"changelog",
|
|
662
|
+
"git",
|
|
663
|
+
"release",
|
|
664
|
+
"documentation"
|
|
665
|
+
],
|
|
666
|
+
"adapters": [
|
|
667
|
+
"codex",
|
|
668
|
+
"claude",
|
|
669
|
+
"cursor",
|
|
670
|
+
"copilot",
|
|
671
|
+
"windsurf",
|
|
672
|
+
"kiro",
|
|
673
|
+
"grok"
|
|
674
|
+
]
|
|
675
|
+
},
|
|
676
|
+
{
|
|
677
|
+
"name": "wikipedia-uk-editor",
|
|
678
|
+
"lookupName": "olko:wikipedia-uk-editor",
|
|
679
|
+
"category": "software-development",
|
|
680
|
+
"path": "packages/software-development/wikipedia-uk-editor",
|
|
681
|
+
"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.",
|
|
682
|
+
"tags": [
|
|
683
|
+
"wikipedia",
|
|
684
|
+
"ukrainian",
|
|
685
|
+
"wikitext",
|
|
686
|
+
"translation",
|
|
687
|
+
"sourcing",
|
|
688
|
+
"editing"
|
|
689
|
+
],
|
|
690
|
+
"adapters": [
|
|
691
|
+
"codex",
|
|
692
|
+
"claude",
|
|
693
|
+
"cursor",
|
|
694
|
+
"copilot",
|
|
695
|
+
"grok",
|
|
696
|
+
"windsurf",
|
|
697
|
+
"kiro",
|
|
698
|
+
"hermes",
|
|
699
|
+
"pi"
|
|
700
|
+
]
|
|
607
701
|
}
|
|
608
702
|
]
|
|
609
703
|
}
|
package/package.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "olko-add-to-my-skills",
|
|
3
|
-
"description": "Copy a newly created skill into this catalog, refresh manifests,
|
|
3
|
+
"description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
|
|
4
4
|
"skills": "./skills"
|
|
5
5
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "olko:add-to-my-skills",
|
|
3
3
|
"version": "0.1.0",
|
|
4
|
-
"description": "Copy a newly created skill into this catalog, refresh manifests,
|
|
4
|
+
"description": "Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push.",
|
|
5
5
|
"skills": "skills/"
|
|
6
6
|
}
|
|
@@ -5,7 +5,7 @@ license: MIT
|
|
|
5
5
|
allowed-tools: Bash, Read, Write, Edit
|
|
6
6
|
compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a writable git repository and access to the source skill repo.
|
|
7
7
|
metadata:
|
|
8
|
-
targets: [
|
|
8
|
+
targets: ["cursor"]
|
|
9
9
|
author: Oleg Koval
|
|
10
10
|
tags:
|
|
11
11
|
- skills
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: add-to-my-skills
|
|
3
|
+
description: Copy a newly created skill from another repo into this catalog, refresh the README and generated manifests, then commit and push the change. Use when the user wants to bring a skill they built elsewhere into this repository.
|
|
4
|
+
license: MIT
|
|
5
|
+
allowed-tools: Bash, Read, Write, Edit
|
|
6
|
+
compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a writable git repository and access to the source skill repo.
|
|
7
|
+
metadata:
|
|
8
|
+
targets: [_source-only]
|
|
9
|
+
author: Oleg Koval
|
|
10
|
+
tags:
|
|
11
|
+
- skills
|
|
12
|
+
- skillshare
|
|
13
|
+
- catalog
|
|
14
|
+
- git
|
|
15
|
+
- commit
|
|
16
|
+
- push
|
|
17
|
+
---
|
|
18
|
+
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
19
|
+
|
|
20
|
+
# Add to My Skills
|
|
21
|
+
|
|
22
|
+
Use this skill when a skill was created in another repository and needs to be copied into this catalog as a first-class package.
|
|
23
|
+
|
|
24
|
+
## Outcome
|
|
25
|
+
|
|
26
|
+
Bring the source skill into `packages/software-development/`, register it in the catalog, refresh generated docs and adapters, and publish the change with a git commit and push.
|
|
27
|
+
|
|
28
|
+
## When to Use
|
|
29
|
+
|
|
30
|
+
- The user created a new `SKILL.md` in another repo and wants it added here
|
|
31
|
+
- The user wants this catalog to become the canonical home for that skill
|
|
32
|
+
- The user wants the README, generated manifests, commit, and push handled in one pass
|
|
33
|
+
|
|
34
|
+
## Clarify Before Acting
|
|
35
|
+
|
|
36
|
+
If any of these are unclear, ask up to 3 questions in one batch before editing:
|
|
37
|
+
|
|
38
|
+
- Source repo or source skill path
|
|
39
|
+
- Final skill name if it should differ from the source
|
|
40
|
+
- Destination branch or remote if the push target is unclear
|
|
41
|
+
|
|
42
|
+
Default assumptions when not specified:
|
|
43
|
+
|
|
44
|
+
- Copy the source skill as a new canonical package in `packages/software-development/<skill-name>/`
|
|
45
|
+
- Keep the source skill name unless the user asks to rename it
|
|
46
|
+
- Use this repository as the destination
|
|
47
|
+
- Commit with a conventional commit message and push to the current branch's upstream
|
|
48
|
+
|
|
49
|
+
## Workflow
|
|
50
|
+
|
|
51
|
+
1. Inspect the source skill:
|
|
52
|
+
- locate the source `SKILL.md`
|
|
53
|
+
- copy any supporting `references/`, `scripts/`, or `assets/` files that the skill needs
|
|
54
|
+
- note any repo-specific assumptions that need to be rewritten for this catalog
|
|
55
|
+
2. Choose the package location:
|
|
56
|
+
- default to `packages/software-development/<skill-name>/`
|
|
57
|
+
- ensure the package directory name matches the `name` frontmatter value
|
|
58
|
+
3. Create or update the canonical package:
|
|
59
|
+
- write `SKILL.md` first
|
|
60
|
+
- keep the frontmatter accurate and concise
|
|
61
|
+
- make the workflow explicit, actionable, and self-contained
|
|
62
|
+
4. Register the package in the repository inventory:
|
|
63
|
+
- add the package to `catalog/skills.json`
|
|
64
|
+
- add it to the appropriate collection file if it belongs in a bundle
|
|
65
|
+
- update `README.md` so the package list, counts, and usage examples stay current
|
|
66
|
+
5. Refresh generated outputs:
|
|
67
|
+
- run `./scripts/build-adapters.sh`
|
|
68
|
+
- run `./scripts/validate-catalog.sh`
|
|
69
|
+
6. Verify the new package actually exists:
|
|
70
|
+
- confirm `packages/software-development/<skill-name>/SKILL.md`
|
|
71
|
+
- confirm generated adapter files and prompt files were created
|
|
72
|
+
7. Commit and push:
|
|
73
|
+
- inspect `git status`
|
|
74
|
+
- commit the change with a conventional message
|
|
75
|
+
- push to the current upstream branch
|
|
76
|
+
|
|
77
|
+
## Git Safety
|
|
78
|
+
|
|
79
|
+
- Never overwrite unrelated changes
|
|
80
|
+
- Never force push unless the user explicitly asks
|
|
81
|
+
- Never commit secrets copied from the source repo
|
|
82
|
+
- If the source skill is incomplete or ambiguous, stop and ask for clarification instead of guessing
|
|
83
|
+
|
|
84
|
+
## Verification
|
|
85
|
+
|
|
86
|
+
- `./scripts/build-adapters.sh` completes successfully
|
|
87
|
+
- `./scripts/validate-catalog.sh` passes
|
|
88
|
+
- `git status` shows only the intended package, catalog, README, and generated files
|
|
89
|
+
- `git push` succeeds to the expected remote
|