@olegkoval/agent-skills 1.34.0 → 1.35.0

package/{packages/wearables/garmin-watchface/adapters/grok → adapters/claude/olko-garmin-kit}/skills/garmin-watchface/scripts/ciq-mock

@@ -4,7 +4,7 @@ against what the watch can actually draw.
 
     ciq-mock out.html a.svg b.svg c.svg
     ciq-mock out.html *.svg --device fenix6pro
-    ciq-mock out.html a.svg --strict          # exit 1 on unsupported/bezel findings only
+    ciq-mock out.html a.svg --strict          # exit 1 on any infidelity
 
 Why this exists
 ---------------
@@ -99,10 +99,6 @@ BANNED_ATTRS = {
     "stroke-opacity": "alphaBlendingSupport is false -- renders fully opaque",
     "stroke-dasharray": "no dash support; draw the segments",
     "filter": "no filter primitives",
-}
-
-# Non-blocking attributes that need guidance but don't fail --strict.
-GUIDANCE_ATTRS = {
     "transform": "fine in the mock, but every rotation must be precomputed in "
                  "Monkey C -- one sin/cos pair per polygon, not per vertex",
 }
@@ -114,7 +110,7 @@ MIN_STROKE = 2
 # ---------------------------------------------------------------- colour ----
 
 def parse_colour(text):
-    """-> (r, g, b) or None when unparseable/none, or "alpha" when alpha-bearing."""
+    """-> (r, g, b) or None when unparseable/none."""
     if not text:
         return None
     t = text.strip().lower()
@@ -122,13 +118,6 @@ def parse_colour(text):
         return None
     if t in NAMED:
         return NAMED[t]
-    # 4-digit or 8-digit hex with alpha
-    m = re.fullmatch(r"#([0-9a-f]{4})", t)
-    if m:
-        return "alpha"
-    m = re.fullmatch(r"#([0-9a-f]{8})", t)
-    if m:
-        return "alpha"
     m = re.fullmatch(r"#([0-9a-f]{3})", t)
     if m:
         return tuple(int(c * 2, 16) for c in m.group(1))
@@ -139,9 +128,6 @@ def parse_colour(text):
     m = re.fullmatch(r"rgba?\(([^)]*)\)", t)
     if m:
         parts = [p.strip() for p in m.group(1).replace("/", ",").split(",")]
-        # If there's a 4th component (alpha), flag it
-        if len(parts) >= 4:
-            return "alpha"
         try:
             return tuple(int(round(float(p.rstrip("%")) * (2.55 if "%" in p else 1)))
                          for p in parts[:3])
@@ -200,8 +186,8 @@ def device_size(device):
     j = json.loads(path.read_text())
     res = j.get("resolution") or j.get("display") or {}
     w, h = res.get("width"), res.get("height")
-    if not w or not h:
-        sys.exit(f"{path} declares no resolution (width or height missing).")
+    if not w:
+        sys.exit(f"{path} declares no resolution.")
     return int(w), int(h)
 
 
@@ -289,19 +275,11 @@ def audit(root, size, round_screen):
             if attr in declared and declared[attr] not in ("1", "1.0", "none"):
                 findings.append(("unsupported", f"{tag} {attr}=\"{declared[attr]}\": {why}"))
 
-        for attr, why in GUIDANCE_ATTRS.items():
-            if attr in declared and declared[attr] not in ("1", "1.0", "none"):
-                findings.append(("limit", f"{tag} {attr}=\"{declared[attr]}\": {why}"))
-
         for attr in COLOUR_ATTRS:
             raw = declared.get(attr)
             if raw is None:
                 continue
             rgb = parse_colour(raw)
-            if rgb == "alpha":
-                findings.append(("unsupported", f"{tag} {attr}=\"{raw}\": alpha channel "
-                                               "not supported (alphaBlendingSupport is false)"))
-                continue
             if rgb is None:
                 if raw.strip().lower() not in ("none", "transparent", "inherit",
                                                "currentcolor"):
@@ -313,11 +291,7 @@ def audit(root, size, round_screen):
         sw = declared.get("stroke-width")
         if sw is not None and declared.get("stroke", "none") != "none":
             try:
-                # Strip "px" suffix if present
-                sw_str = str(sw).strip()
-                if sw_str.endswith("px"):
-                    sw_str = sw_str[:-2].strip()
-                if float(sw_str) < MIN_STROKE:
+                if float(sw) < MIN_STROKE:
                     findings.append(("stroke", f"{tag} stroke-width={sw}: below {MIN_STROKE}px "
                                                "breaks up with no anti-aliasing"))
             except ValueError:
@@ -400,13 +374,13 @@ document.querySelector('#dim').addEventListener('click', function () {
 """
 
 
-def card(name, markup, w, h, findings, colours, round_screen, card_index):
+def card(name, markup, w, h, findings, colours, round_screen):
     clip = ""
     if round_screen:
-        clip = (f'<defs><clipPath id="glass_{card_index}">'
+        clip = (f'<defs><clipPath id="glass_{abs(hash(name))}">'
                 f'<circle cx="{w/2}" cy="{h/2}" r="{min(w, h)/2}"/>'
                 f"</clipPath></defs>")
-        markup = f'<g clip-path="url(#glass_{card_index})">{markup}</g>'
+        markup = f'<g clip-path="url(#glass_{abs(hash(name))})">{markup}</g>'
 
     swatches = "".join(
         f'<div class="sw" style="background:{hexof(quantize(c))}" '
@@ -445,8 +419,7 @@ def main():
     ap.add_argument("--no-quantize", action="store_true",
                     help="render the colours as written (dishonest; for comparison only)")
     ap.add_argument("--strict", action="store_true",
-                    help="exit 1 if any variant has unsupported-feature or bezel findings "
-                         "(path/text limits are non-blocking)")
+                    help="exit 1 if any variant has an unsupported/bezel finding")
     args = ap.parse_args()
 
     if args.device:
@@ -456,7 +429,7 @@ def main():
     round_screen = (not args.rect) and w == h
 
     cards, blocking = [], 0
-    for idx, name in enumerate(args.svg):
+    for name in args.svg:
         path = Path(name)
         if not path.is_file():
             sys.exit(f"No such file: {path}")
@@ -466,7 +439,7 @@ def main():
             root = apply_quantize(root)
         blocking += sum(1 for kind, _ in findings if kind in ("unsupported", "bezel"))
         cards.append(card(path.stem, inner_markup(root), w, h,
-                          findings, colours, round_screen, idx))
+                          findings, colours, round_screen))
 
         print(f"{path.stem}: {len(findings)} finding(s)")
         for kind, msg in findings:

package/adapters/claude/olko-git-tools/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-git-tools",
+  "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene.",
+  "skills": "./skills"
+}

package/adapters/claude/olko-github-pr/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-github-pr",
+  "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage.",
+  "skills": "./skills"
+}

package/adapters/claude/olko-obsidian/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-obsidian",
+  "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine.",
+  "skills": "./skills"
+}

package/adapters/claude/olko-product/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-product",
+  "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, launch plans.",
+  "skills": "./skills"
+}

package/adapters/claude/olko-reflection/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-reflection",
+  "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning.",
+  "skills": "./skills"
+}

package/{packages/software-development/retro-analysis/adapters/claude → adapters/claude/olko-reflection}/skills/retro-analysis/SKILL.md

@@ -151,7 +151,25 @@ For `compare` or any window with a prior snapshot:
 
 Store a JSON snapshot with stable keys, UTC timestamps, resolved window, scope, repository identity, commit/PR identifiers, metric values, evidence limitations, and a short list of findings. Keep narrative prose out of fields intended for machine comparison. A snapshot is an aid to future analysis, not a source of truth that overrides current evidence.
 
-## 5. Produce the report
+## 5. Optionally promote durable lessons
+
+This phase is opt-in. A retrospective remains read-only unless the user or the surrounding workflow explicitly requests promotion to the shared ledger. Do not silently turn analysis into a write operation.
+
+Before adding any finding:
+
+1. Locate and read the current shared ledger. When a Git-backed repository ledger exists, read that repository file directly and treat it as authoritative. If it is absent or inaccessible, report `NOT_AVAILABLE` and do not claim that the ledger was checked.
+2. Classify the finding as one of:
+   - `local action` — a project- or task-specific follow-up that belongs in the report or backlog, not the shared ledger.
+   - `lesson` — a durable practice that generalizes across projects.
+   - `trap` — a non-obvious failure mode that can silently produce incorrect work.
+   - `preference` — a stable way the operator wants agents to work.
+3. Promote only non-obvious, durable, cross-project lessons, traps, or preferences. Keep local actions in the retrospective or project task system.
+4. Attach evidence to every promoted finding: a source path, commit, check, or other redacted reference, or the concrete failure that caused the rule. Do not promote an unsupported impression.
+5. Do not duplicate existing project instructions, shared-ledger notes, or behavior already enforced by an automated check. A thin ledger is more useful than a repetitive one.
+
+When promotion is authorized, append new notes using the current ledger schema; never rewrite, reorder, or overwrite existing entries. If no note is justified, append nothing. Report each added note ID, or `NOT_WRITTEN` when no note was added, promotion was not requested, or the ledger could not be safely updated.
+
+## 6. Produce the report
 
 Lead with a concise, shareable summary of the period. Then use this order:
 
@@ -170,7 +188,7 @@ Lead with a concise, shareable summary of the period. Then use this order:
 
 Use compact tables for exact metrics and prose for interpretation. Label inference as inference. Link or name evidence paths/commit IDs where useful, but never paste private content.
 
-## 6. End-of-task handoff
+## 7. End-of-task handoff
 
 If this run is explicitly closing a completed implementation, continue with `olko:wrap-up`:
 

package/{packages/software-development/wrap-up/adapters/claude → adapters/claude/olko-reflection}/skills/wrap-up/SKILL.md

@@ -67,20 +67,40 @@ Clean only paths created by this task or explicitly named for cleanup.
 
 ## 6. Report the result
 
-Lead with the outcome. Include concise evidence, cleanup performed, items intentionally preserved, and the smallest next action for any blocker. Always finish with this receipt, using `NOT_APPLICABLE` for out-of-scope gates and `NOT_RUN` for applicable checks that were not executed:
+Lead with the outcome. Use a short `DELIVERY RECEIPT` heading and a one- or
+two-sentence summary before the fields. Add `STATUS`, `NEXT_PHASE`, and
+`NEXT_STEP` near the top when follow-up work remains. Keep the required fields
+flush-left and grouped with one blank line between logical groups, not between
+every field. Keep each value concise and avoid repeating the same prose. Do
+not use Markdown tables, decorative separators, bullets, emojis, or indented
+continuation lines inside the canonical field block. Put `FINAL_STATUS` last.
+Add `LOCAL_COMMIT` when a local commit exists. Always finish with this receipt,
+using `NOT_APPLICABLE` for out-of-scope gates and `NOT_RUN` for applicable
+checks that were not executed:
 
 ```text
+DELIVERY RECEIPT
+
+<short outcome summary>
+STATUS: <DELIVERED | BLOCKED | INTENTIONALLY_UNCHANGED>
+NEXT_PHASE: <next phase or NOT_APPLICABLE>
+NEXT_STEP: <single smallest next action or NOT_APPLICABLE>
+
 OBJECTIVE:
 CHANGED:
 NOT_CHANGED:
+
 TESTS:
 BUILD:
+
 REMOTE:
 PR:
 CI:
 DEPLOYMENT:
 DEVICE_OR_HUMAN_QA:
+
 KNOWN_LIMITATIONS:
+LOCAL_COMMIT: <hash and subject, or NOT_APPLICABLE>
 FINAL_STATUS:
 ```
 

package/adapters/claude/olko-release/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-release",
+  "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine.",
+  "skills": "./skills"
+}

package/adapters/claude/olko-skill-meta/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-skill-meta",
+  "description": "Author and maintain agent skills and the AI toolchain itself.",
+  "skills": "./skills"
+}

package/{packages/software-development/shared-knowledge-artifact/adapters/claude → adapters/claude/olko-skill-meta}/skills/shared-knowledge-artifact/SKILL.md

@@ -19,7 +19,7 @@ metadata:
 
 # shared-knowledge-artifact
 
-Publish one private Artifact page that acts as an append-only knowledge ledger which multiple agents (and the user) read before starting work and write to when reality corrects them. The page **is** the record: it stores its own data and publishes new versions of itself, so nothing depends on a server or on local files.
+Use a private Artifact page as an optional rendered and editing surface for an append-only knowledge ledger. Multiple agents (and the user) can read the lessons before starting work and append corrections afterwards. The Artifact is not universally authoritative: when a repository contains a Git-backed ledger, that repository ledger is the canonical record; the Artifact mirrors it and provides a convenient view or edit surface. Without a Git ledger, the published Artifact state is the durable record for that Artifact.
 
 ## Trigger phrases
 
@@ -32,12 +32,20 @@ Publish one private Artifact page that acts as an append-only knowledge ledger w
 
 1. Invoke the `artifact-capabilities` skill — mandatory before declaring `capabilities` or writing any `window.claude.*` code.
 2. Invoke the `artifact-design` skill — calibrates the design treatment.
-3. Read the user's actual rules (`CLAUDE.md`, any verification/preferences doc, agent memory) and **seed the ledger with 6-10 real lessons already recorded there**. No lorem, no invented examples — a ledger that opens with fake entries never gets used.
+3. Read the user's actual rules (`CLAUDE.md`, any verification/preferences doc, agent memory), and read the current repository ledger directly when one exists. **Seed the ledger with real lessons already recorded there — use 6-10 when that many exist, or all available real lessons if fewer than six are found**. No lorem, no invented examples — a ledger that opens with fake entries never gets used.
+
+## Authority and reconciliation
+
+- If a Git-backed ledger exists, it is authoritative over the Artifact. Codex and other non-Claude agents must read and update that repository ledger directly; they must not require Artifact access.
+- Before writing either surface, read the current repository ledger and the current Artifact state when both exist. Do not write from a stale page or cached copy.
+- Notes added in the Artifact must be appended back to the Git ledger, using the repository's schema and append-only rules, before they are treated as shared guidance. Record the resulting note ID or the reason it was not written.
+- If the Artifact and Git ledger disagree, preserve both histories but resolve the usable guidance in favor of Git. Refresh or reconcile the Artifact from Git rather than overwriting the repository record.
+- If no Git ledger exists, the Artifact's published `#ledger-state` is authoritative for that Artifact. Do not imply that it is shared with non-Claude agents unless it has been exported to a repository ledger.
 
 ## Persistence mechanism
 
 - Declare `capabilities: {artifact: {}}` at publish time.
-- Store the data as a JSON object inside `<script type="application/json" id="ledger-state">`. That block is the authoritative record; the visible page is **rendered from it** at load. Never serialize the live DOM to save.
+- Store the Artifact surface's data as a JSON object inside `<script type="application/json" id="ledger-state">`. That block is authoritative for the published Artifact version; the visible page is **rendered from it** at load. When a Git ledger exists, this page state remains a mirror and Git remains authoritative overall. Never serialize the live DOM to save.
 - To persist: snapshot `document.documentElement.outerHTML` **once at script start** (pristine source, before any rendering), then on save splice the new JSON into that snapshot's `#ledger-state` block, prepend `<!doctype html>`, and call `artifact.publish(doc)`.
 - Get the namespace with `const artifact = await claude.use("artifact")`; branch on `null` (this view cannot write) and render a read-only state instead of a broken control.
 - Handle publish errors by code: `conflict` means someone published first and every view reloads to the winner — no retry, tell the person to re-add; `not_granted` / `not_writer` means read-only.
@@ -64,7 +72,7 @@ Kinds: **lesson** = a habit that holds; **trap** = something that silently produ
 - Note list, newest first: kind tag, scope tag, author, date, title, body, and a `Why:` line. Kind tags use semantic colour (trap = critical, pref = warning, lesson = accent), separate from the page accent.
 - Scope filter chips derived from the data, including an `all` chip, with `aria-pressed` state.
 - An "Add a note" form (kind, scope, author, title, body, why) that appends to the JSON and publishes, with an inline status line reporting published / conflict / read-only.
-- A "Protocol for agents" section **on the page itself**: read the page with the Artifact tool `action: "read"` before substantive work; parse the `#ledger-state` JSON, never scrape the DOM; **append, don't rewrite**; re-read before writing because another agent may have published since; one fact per note with the failure that caused it. Include the schema snippet.
+- A "Protocol for agents" section **on the page itself**: when a Git ledger exists, read that repository ledger directly before substantive work; Codex and other non-Claude agents must use it directly. Claude agents may read the Artifact with the Artifact tool `action: "read"` as a rendered surface, then parse the `#ledger-state` JSON rather than scraping the DOM. In either case, **append, don't rewrite**, re-read before writing because another agent may have updated the source, and include the failure that caused each note. Include the schema snippet and the Git reconciliation rule.
 - Gatekeeping copy: only non-obvious, durable, cross-cutting lessons. If a repo's `CLAUDE.md` already says it, or a review bot already catches it, leave it out — a littered ledger is worse than a thin one.
 
 ## Design constraints
@@ -78,11 +86,12 @@ Kinds: **lesson** = a habit that holds; **trap** = something that silently produ
 
 ## Deliverable
 
-Write the HTML to a file, publish it with the Artifact tool, then report:
+When an Artifact surface is requested, write the HTML to a file and publish it with the Artifact tool, then report:
 
 - the URL;
 - that it stays private until shared from the page's share menu;
-- the exact instructions another agent needs — read via Artifact `action: "read"` with that URL, and write by appending to `notes` and republishing **with `url` set to that URL** (a publish *without* `url` forks a separate artifact instead of updating this one).
+- the exact instructions another Claude agent needs — read via Artifact `action: "read"` with that URL, and write by appending to `notes` and republishing **with `url` set to that URL** (a publish *without* `url` forks a separate artifact instead of updating this one);
+- when a Git ledger exists, the repository path and the reconciliation result, making clear that other agents should read and write Git directly and that Git wins any disagreement.
 
 ## Notes
 

package/adapters/claude/olko-web-ops/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-web-ops",
+  "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes.",
+  "skills": "./skills"
+}

package/adapters/codex/olko-apple-kit/README.md

@@ -0,0 +1,8 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-apple-kit
+
+Use the canonical skills directly:
+
+- `plugins/olko-apple-kit/skills/apple-store-submit/SKILL.md`
+- `plugins/olko-apple-kit/skills/macos-menubar-app/SKILL.md`

package/adapters/codex/olko-creative/README.md

@@ -0,0 +1,10 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-creative
+
+Use the canonical skills directly:
+
+- `plugins/olko-creative/skills/gallery/SKILL.md`
+- `plugins/olko-creative/skills/fill-music-player/SKILL.md`
+- `plugins/olko-creative/skills/vinted-listing/SKILL.md`
+- `plugins/olko-creative/skills/wikipedia-uk-editor/SKILL.md`

package/adapters/codex/olko-garmin-kit/README.md

@@ -0,0 +1,7 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-garmin-kit
+
+Use the canonical skills directly:
+
+- `plugins/olko-garmin-kit/skills/garmin-watchface/SKILL.md`

package/adapters/codex/olko-git-tools/README.md

@@ -0,0 +1,9 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-git-tools
+
+Use the canonical skills directly:
+
+- `plugins/olko-git-tools/skills/git-commit/SKILL.md`
+- `plugins/olko-git-tools/skills/gh-cli/SKILL.md`
+- `plugins/olko-git-tools/skills/branch-cleanup/SKILL.md`

package/adapters/codex/olko-github-pr/README.md

@@ -0,0 +1,16 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-github-pr
+
+Use the canonical skills directly:
+
+- `plugins/olko-github-pr/skills/pr-finalize/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-finalize-complete/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-to-green/SKILL.md`
+- `plugins/olko-github-pr/skills/pr-description-writer/SKILL.md`
+- `plugins/olko-github-pr/skills/qodoloop/SKILL.md`
+- `plugins/olko-github-pr/skills/coderabbitloop/SKILL.md`
+- `plugins/olko-github-pr/skills/codexloop/SKILL.md`
+- `plugins/olko-github-pr/skills/geminiloop/SKILL.md`
+- `plugins/olko-github-pr/skills/ci-fix-loop/SKILL.md`
+- `plugins/olko-github-pr/skills/dependabot-triage/SKILL.md`

package/adapters/codex/olko-obsidian/README.md

@@ -0,0 +1,7 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-obsidian
+
+Use the canonical skills directly:
+
+- `plugins/olko-obsidian/skills/morning-routine/SKILL.md`

package/adapters/codex/olko-product/README.md

@@ -0,0 +1,10 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-product
+
+Use the canonical skills directly:
+
+- `plugins/olko-product/skills/product-builder/SKILL.md`
+- `plugins/olko-product/skills/mvp-oneshot/SKILL.md`
+- `plugins/olko-product/skills/starter-rules/SKILL.md`
+- `plugins/olko-product/skills/viral-launch/SKILL.md`

package/adapters/codex/olko-reflection/README.md

@@ -0,0 +1,11 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-reflection
+
+Use the canonical skills directly:
+
+- `plugins/olko-reflection/skills/self-critique/SKILL.md`
+- `plugins/olko-reflection/skills/review-past-performance/SKILL.md`
+- `plugins/olko-reflection/skills/retro-analysis/SKILL.md`
+- `plugins/olko-reflection/skills/crash-course/SKILL.md`
+- `plugins/olko-reflection/skills/wrap-up/SKILL.md`

package/adapters/codex/olko-release/README.md

@@ -0,0 +1,11 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-release
+
+Use the canonical skills directly:
+
+- `plugins/olko-release/skills/semantic-release-beta/SKILL.md`
+- `plugins/olko-release/skills/open-source-publisher/SKILL.md`
+- `plugins/olko-release/skills/release-day/SKILL.md`
+- `plugins/olko-release/skills/changelog-generator/SKILL.md`
+- `plugins/olko-release/skills/store-listing-copy/SKILL.md`

package/adapters/codex/olko-skill-meta/README.md

@@ -0,0 +1,9 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-skill-meta
+
+Use the canonical skills directly:
+
+- `plugins/olko-skill-meta/skills/add-to-my-skills/SKILL.md`
+- `plugins/olko-skill-meta/skills/promptctl/SKILL.md`
+- `plugins/olko-skill-meta/skills/ai-tools-setup/SKILL.md`

package/adapters/codex/olko-web-ops/README.md

@@ -0,0 +1,9 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# Codex adapter: olko-web-ops
+
+Use the canonical skills directly:
+
+- `plugins/olko-web-ops/skills/cloudflare-block-countries/SKILL.md`
+- `plugins/olko-web-ops/skills/search-console-indexing-audit/SKILL.md`
+- `plugins/olko-web-ops/skills/docs-index-keeper/SKILL.md`

package/adapters/cursor/olko-apple-kit/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko-apple-kit",
+  "version": "0.1.0",
+  "description": "Build and ship Apple platform apps: macOS menubar apps, App Store submissions.",
+  "skills": "skills/"
+}

package/adapters/cursor/olko-creative/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko-creative",
+  "version": "0.1.0",
+  "description": "Creative and personal projects: photo galleries, music players, listings, wiki editing.",
+  "skills": "skills/"
+}

package/adapters/cursor/olko-garmin-kit/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko-garmin-kit",
+  "version": "0.1.0",
+  "description": "Build, test and publish Garmin Connect IQ watch faces.",
+  "skills": "skills/"
+}

package/{packages/wearables/garmin-watchface/adapters/claude → adapters/cursor/olko-garmin-kit}/skills/garmin-watchface/references/design-proposals.md

@@ -21,7 +21,7 @@ extras gets approved and then cannot be implemented, and the gap is discovered
 after the geometry is already committed.
 
 `scripts/ciq-mock` exists to close that gap: it renders each proposal with every
-colour quantised to the lattice, inside the round bezel, and lists what will not
+colour quantized to the lattice, inside the round bezel, and lists what will not
 survive.
 
 ```bash
@@ -64,9 +64,8 @@ reflectance. See `display.md`.
 
 `ciq-mock` checks the farthest point of every `rect`, `circle`, `ellipse`,
 `line`, `polygon` and `polyline` against the glass radius. It does **not** check
-`<path>` shapes -- that needs a real path renderer and remains unchecked -- and
-it does not validate text extents (font metrics come from the device, not the
-browser).
+`<path>` -- that needs a real path renderer -- and it does not know how large
+your text will be.
 
 The check that matters most is the rectangle one: a rectangle inscribed in a
 circle fails at its **corners** long before its sides, and the amount by which
@@ -76,7 +75,7 @@ problem: a marker of width `w` ending at radius `r` actually reaches
 
 ## Proposing to a human
 
-Exactly three variants, not one and not seven. One is an ultimatum; seven is a survey.
+Three variants, not one and not seven. One is an ultimatum; seven is a survey.
 
 Make the three differ on **one axis you actually want an answer about** --
 information density, or dial polarity, or analog versus digital -- and hold
@@ -85,7 +84,7 @@ everything else constant. Variants that differ in five ways at once produce
 
 State what is fixed by the device (resolution, colour count, no alpha) so the
 feedback lands on choices rather than constraints, and say plainly that colours
-shown are post-quantisation.
+shown are post-quantization.
 
 ## After approval
 

package/{packages/wearables/garmin-watchface/adapters/grok → adapters/cursor/olko-garmin-kit}/skills/garmin-watchface/references/devices.md

@@ -185,7 +185,7 @@ order problem.
 Grep the entire `source/` tree, not just `Layout.mc`:
 
 ```bash
-grep -rn "const [A-Z_][A-Z_0-9]* =" source/
+grep -rn "const [A-Z_0-9]* = -\?[0-9]" source/
 ```
 
 Then sort what you find into three buckets:

package/{packages/wearables/garmin-watchface/adapters/cursor → adapters/cursor/olko-garmin-kit}/skills/garmin-watchface/references/inspiration-wizard.md

@@ -47,17 +47,16 @@ Three axes worth gathering along:
   proportions and polarity are what make it recognisable. Get those first; see
   the homage section in `SKILL.md`.
 - **Palette** -- from a brand domain, or from an image the user already owns.
-  Everything comes back quantised, so what you show is what ships.
+  Everything comes back quantized, so what you show is what ships.
 - **Prior art** -- read other people's Monkey C for *technique*, not for code.
   Most Connect IQ repositories carry no licence, which means all rights
   reserved.
 
-**IP boundary.** Use brand research and design references as inspiration only:
-implementation must be original, and distinctive creative elements or
-compositions must not be copied verbatim. Names, wordmarks and logos are not
-permissible -- not in the face, the launcher icon, the screenshots or the copy.
-`ciq-inspire --brand` will return another company's logo without complaint; that
-is a research artefact, not an asset. See `store.md`.
+**IP boundary.** Colours, proportions and layout ideas are fair to borrow. Names,
+wordmarks and logos are not -- not in the face, the launcher icon, the
+screenshots or the copy. `ciq-inspire --brand` will return another company's
+logo without complaint; that is a research artefact, not an asset. See
+`store.md`.
 
 ---
 
@@ -88,10 +87,10 @@ because each changes the code shape rather than the look:
 
 ---
 
-## Stage 3 -- Diverge: exactly three variants as SVG
+## Stage 3 -- Diverge: three variants as SVG
 
-Write exactly three SVG files that differ on **the one axis you asked about**,
-holding everything else constant. Then:
+Write three SVG files that differ on **the one axis you asked about**, holding
+everything else constant. Then:
 
 ```bash
 <skill-dir>/scripts/ciq-mock /tmp/proposals.html a.svg b.svg c.svg --device <target>

package/{packages/wearables/garmin-watchface/adapters/claude → adapters/cursor/olko-garmin-kit}/skills/garmin-watchface/scripts/ciq-inspire

@@ -80,16 +80,8 @@ def parse_hex(text):
 
 def get(url, headers=None):
     req = urllib.request.Request(url, headers={"User-Agent": UA, **(headers or {})})
-    try:
-        with urllib.request.urlopen(req, timeout=20) as resp:
-            data = json.loads(resp.read().decode("utf-8"))
-            if not isinstance(data, dict):
-                print(f"API returned non-dict response", file=sys.stderr)
-                return None
-            return data
-    except json.JSONDecodeError as exc:
-        print(f"API returned invalid JSON: {exc}", file=sys.stderr)
-        return None
+    with urllib.request.urlopen(req, timeout=20) as resp:
+        return json.loads(resp.read().decode("utf-8"))
 
 
 # ------------------------------------------------------------- brandfetch ----
@@ -110,9 +102,6 @@ def from_brandfetch(domain):
         print(f"Brandfetch unreachable: {exc.reason}", file=sys.stderr)
         return None
 
-    if data is None:
-        return None
-
     colours = []
     for c in data.get("colors") or []:
         rgb = parse_hex(c.get("hex"))
@@ -156,13 +145,6 @@ def from_image(path, count):
         q = quantize(raw[i:i + 3])
         tally[q] = tally.get(q, 0) + 1
     total = sum(tally.values())
-    if not tally or total == 0:
-        return {
-            "source": f"image:{Path(path).name}",
-            "name": Path(path).stem,
-            "colours": [],
-            "typefaces": [],
-        }
     ranked = sorted(tally.items(), key=lambda kv: -kv[1])[:count]
     return {
         "source": f"image:{Path(path).name}",
@@ -321,7 +303,7 @@ def main():
         }, indent=2) + "\n", encoding="utf-8")
         print(f"\nWrote {args.json}")
 
-    print("\nNext: draw exactly three variants as SVG and run ciq-mock on them.")
+    print("\nNext: draw two or three variants as SVG and run ciq-mock on them.")
     return 0