@olegkoval/agent-skills 1.34.0 → 1.35.0

package/{packages/wearables/garmin-watchface/adapters/cursor → adapters/cursor/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/cursor/olko-git-tools/plugin.json

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

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

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

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

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

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

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

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

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

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

@@ -3,7 +3,6 @@ name: retro-analysis
 description: Produce a recurring engineering retrospective from repository history, delivery evidence, work patterns, code-quality signals, and prior snapshots, with repository, comparison, and cross-project modes.
 license: MIT
 metadata:
-  targets: ["cursor"]
   author: Oleg Koval
   tags:
     - retrospective
@@ -152,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:
 
@@ -171,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/cursor → adapters/cursor/olko-reflection}/skills/wrap-up/SKILL.md

@@ -4,7 +4,6 @@ description: Verify that a completed implementation matches its original objecti
 license: MIT
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, Grok, and other Agent Skills compatible tools.
 metadata:
-  targets: ["cursor"]
   author: Oleg Koval
   tags:
     - delivery
@@ -68,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/cursor/olko-release/plugin.json

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

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

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

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

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

package/adapters/grok/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/{packages/software-development/apple-store-submit/adapters/cursor → adapters/grok/olko-apple-kit}/skills/apple-store-submit/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires Xcode, an Apple Developer account, and App Store Connect access.
 metadata:
-  targets: ["cursor"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - apple

package/{packages/software-development/macos-menubar-app/adapters/cursor → adapters/grok/olko-apple-kit}/skills/macos-menubar-app/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 allowed-tools: Bash, Read, Write, Edit
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires Xcode 15+, macOS 13+ deployment target, and an Apple Developer account for App Store distribution.
 metadata:
-  targets: ["cursor"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - macos

package/adapters/grok/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/{packages/music/fill-music-player/adapters/cursor → adapters/grok/olko-creative}/skills/fill-music-player/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 allowed-tools: Bash
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires shell access and the fill-music-player CLI or underlying script in the target environment.
 metadata:
-  targets: ["cursor"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - music

package/{packages/photography/gallery/adapters/cursor → adapters/grok/olko-creative}/skills/gallery/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 allowed-tools: Bash, Read, Write, WebSearch, WebFetch
 compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Requires a project that contains the gallery scripts and expected data layout.
 metadata:
-  targets: ["cursor"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - photos

package/{packages/software-development/wikipedia-uk-editor/adapters/cursor → adapters/grok/olko-creative}/skills/wikipedia-uk-editor/SKILL.md

@@ -5,7 +5,7 @@ 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: ["cursor"]
+  targets: [_source-only]
   author: Oleg Koval
   tags:
     - wikipedia

package/adapters/grok/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/cursor → adapters/grok/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 → adapters/grok/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/grok → adapters/grok/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/grok → adapters/grok/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
 
 

package/{packages/wearables/garmin-watchface/adapters/claude → adapters/grok/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: