@olegkoval/agent-skills 1.47.0 → 1.47.1

package/.github/prompts/ux-ui-audit-loop.prompt.md

@@ -162,11 +162,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -191,6 +218,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/.kiro/steering/ux-ui-audit-loop.md

@@ -161,11 +161,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -190,6 +217,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/.windsurf/rules/ux-ui-audit-loop.md

@@ -160,11 +160,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -189,6 +216,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/adapters/claude/olko-product/skills/ux-ui-audit-loop/SKILL.md

@@ -173,11 +173,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -202,6 +229,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/adapters/cursor/olko-product/skills/ux-ui-audit-loop/SKILL.md

@@ -173,11 +173,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -202,6 +229,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/adapters/grok/olko-product/skills/ux-ui-audit-loop/SKILL.md

@@ -173,11 +173,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -202,6 +229,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "private": false,
   "publishConfig": {
     "access": "public"

package/plugins/olko-apple-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-apple-kit",
   "description": "Build and ship Apple platform apps: macOS menubar apps, App Store submissions.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-creative/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-creative",
   "description": "Creative and personal projects: photo galleries, music players, listings, wiki editing.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-garmin-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-garmin-kit",
   "description": "Build, test and publish Garmin Connect IQ watch faces.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-git-tools",
   "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-github-pr",
   "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-obsidian",
   "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-product",
   "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, UX/UI quality loops, launch plans.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-product/skills/ux-ui-audit-loop/SKILL.md

@@ -172,11 +172,38 @@ Otherwise stop at the round limit or blocker and report the remaining ledger hon
 
 - Follow an existing repository convention when one exists.
 - Otherwise store artifacts under an OS temporary directory named `ux-ui-audit-loop-<run-id>` and report the absolute path.
+- Generate a readable Markdown report at `<artifact-directory>/ux-ui-audit-report.md` before the final response. The report is mandatory even when no fix is made.
 - Redact or omit secrets and sensitive personal data before persisting screenshots, DOM or accessibility data, console output, request details, or reports. Never retain credentials, tokens, or browser storage.
 - Use deterministic names such as `round-01-before-mobile-form-error.png`.
 - Do not add large screenshots to git, modify `.gitignore`, or delete user artifacts unless requested.
 - Retain enough evidence to compare the first baseline with the final state.
 
+The report must be human-readable without inspecting tool logs. For every scoped state and viewport, include:
+
+- a before screenshot link and the matching after screenshot link; use relative Markdown image links when the report and screenshots share an artifact directory
+- the exact route, viewport, and state setup
+- a short before/after comparison describing what changed, what stayed unchanged, and any remaining issue
+- finding IDs with severity and status, including `not-reproduced`, `accepted`, or `blocked` explanations
+- verification commands and browser evidence with pass/fail/not-run status
+
+Use this minimum comparison shape:
+
+```markdown
+## Before / After
+
+| State | Viewport | Before | After | What changed |
+|---|---:|---|---|---|
+| Initial render | 390x844 | [before](round-01-before-mobile.png) | [after](round-01-after-mobile.png) | Mobile toolbar no longer clips labels; content width remains unchanged. |
+
+### Initial render — 390x844
+
+| Before | After |
+|---|---|
+| ![Before](round-01-before-mobile.png) | ![After](round-01-after-mobile.png) |
+```
+
+If a screenshot cannot be captured, mark that pair `NOT_CAPTURED` with the exact blocker; never imply a visual comparison was completed.
+
 ## Final Report
 
 Return a concise report with:
@@ -201,6 +228,9 @@ VERIFICATION
 
 ARTIFACTS
 <absolute artifact directory>
+
+REPORT
+<absolute path to ux-ui-audit-report.md>
 ```
 
 Use `CLEAN` only when the successful stop conditions are met. Separate browser evidence, automated tests, deployment state, and human design acceptance. Recommend one smallest next action for every blocker or remainder.

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-reflection",
   "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-release",
   "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-skill-meta",
   "description": "Author and maintain agent skills and the AI toolchain itself.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "olko-web-ops",
   "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes.",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "author": {
     "name": "Oleg Koval"
   },