dart-asset-normalization

Estrellas10

Forks0

Actualizado1 de mayo de 2026 a las 11:12

Normalize and verify bundled Dart marker PNG assets in autodarts-xconfig. Use when a file under `src/assets/darts/` is added, changed, replaced, visually misaligned, or when Dart marker tips no longer sit exactly on the board marker. Also use when updating Dart image geometry constants or asset tests.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

thomasasen

thomasasen/autodarts-xconfig

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

Explorador de archivos

2 archivos

SKILL.md

readonly

name	dart-asset-normalization
description	Normalize and verify bundled Dart marker PNG assets in autodarts-xconfig. Use when a file under `src/assets/darts/` is added, changed, replaced, visually misaligned, or when Dart marker tips no longer sit exactly on the board marker. Also use when updating Dart image geometry constants or asset tests.

Goal

Keep every bundled Dart marker image aligned to the runtime hotspot used by dart-marker-darts.

Core Rules

work in src/assets/darts/, not dist/
use npm run check:darts before and after changes to Dart PNGs
use npm run normalize:darts to repair misaligned Dart PNGs
do not manually edit PNG bytes or hand-tune per-image offsets unless the script cannot safely normalize an asset
keep runtime constants in src/features/dart-marker-darts/logic.js aligned with the normalizer target canvas
update tests/runtime/feature-assets.test.js hashes when normalized image bytes intentionally change

Workflow

Inspect changed files with git diff --name-only and identify any src/assets/darts/Dart_*.png changes.
Run npm run check:darts.
If the check fails, run npm run normalize:darts.
Re-run npm run check:darts.
If PNG bytes changed intentionally, update the asset hash snapshots in tests/runtime/feature-assets.test.js.
Run the closest tests:
- node --test tests/runtime/feature-assets.test.js
- node --test tests/runtime/dart-marker-darts-runtime.test.js
For final validation, use $validate-repo-change.

Hotspot Contract

The normalizer targets the constants exported by src/features/dart-marker-darts/logic.js:

canvas width: DART_IMAGE_SOURCE_WIDTH
canvas height: DART_IMAGE_SOURCE_HEIGHT
tip y-position: DART_IMAGE_TIP_Y
tip x-position: 0

The script estimates the tip from the leftmost visible alpha band. This is appropriate for the current Dart assets because every Dart points left and uses transparency around the graphic.

Failure Handling

If npm run normalize:darts reports that normalization would clip visible pixels, do not force it. The image needs manual canvas preparation or a larger shared canvas plus matching runtime constant/test updates.

Más de este repositorio

mismo repositorio

package-userscript-release

thomasasen/autodarts-xconfig

Package or verify an autodarts-xconfig userscript release. Use only for explicit release, finalize, package, ship, publish, version bump, `dist/` refresh, or publication-state verification work. Do not use for ordinary code changes.

2026-07-1610

clean-sonar-findings

thomasasen/autodarts-xconfig

Use for explicit SonarQube issue cleanup, Sonar code smells, low-risk static-analysis fixes, and touched-scope Sonar remediation. Do not use for normal validation unless cleanup is explicitly requested.

2026-07-1410

debug-live-autodarts-dom

thomasasen/autodarts-xconfig

Use for live browser, DOM inspection, Playwright MCP, Chrome DevTools MCP, Autodarts page inspection, reproduction, console/network checks, and UI verification tasks. Do not use for ordinary static code review.

2026-06-1910

validate-repo-change

thomasasen/autodarts-xconfig

Choose and report the smallest sufficient local validation for an autodarts-xconfig change. Use after meaningful source changes, when validation scope is unclear, or when final reporting must include residual risk. Do not use for Tier 0-only edits unless needed to document skipped validation.

2026-06-1810

oldrepo-parity-recovery

thomasasen/autodarts-xconfig

Recover known-good behavior from `.oldrepo` without reintroducing the old structure. Use when the current modular implementation diverges from proven legacy behavior and the task is to recover that behavior in the right modern layer. Do not use for greenfield features with no legacy predecessor.

2026-06-0410

xconfig-effect-preview-contract

thomasasen/autodarts-xconfig

Use when adding, fixing, or reviewing xConfig administration previews for feature effects, especially hover/focus previews that must reflect the real runtime effect without leaking timers, classes, DOM state, or fake CSS-only behavior.

2026-05-1310

name	dart-asset-normalization
description	Normalize and verify bundled Dart marker PNG assets in autodarts-xconfig. Use when a file under `src/assets/darts/` is added, changed, replaced, visually misaligned, or when Dart marker tips no longer sit exactly on the board marker. Also use when updating Dart image geometry constants or asset tests.

Goal

Keep every bundled Dart marker image aligned to the runtime hotspot used by dart-marker-darts.

Core Rules

work in src/assets/darts/, not dist/
use npm run check:darts before and after changes to Dart PNGs
use npm run normalize:darts to repair misaligned Dart PNGs
do not manually edit PNG bytes or hand-tune per-image offsets unless the script cannot safely normalize an asset
keep runtime constants in src/features/dart-marker-darts/logic.js aligned with the normalizer target canvas
update tests/runtime/feature-assets.test.js hashes when normalized image bytes intentionally change

Workflow

Inspect changed files with git diff --name-only and identify any src/assets/darts/Dart_*.png changes.
Run npm run check:darts.
If the check fails, run npm run normalize:darts.
Re-run npm run check:darts.
If PNG bytes changed intentionally, update the asset hash snapshots in tests/runtime/feature-assets.test.js.
Run the closest tests:
- node --test tests/runtime/feature-assets.test.js
- node --test tests/runtime/dart-marker-darts-runtime.test.js
For final validation, use $validate-repo-change.

Hotspot Contract

The normalizer targets the constants exported by src/features/dart-marker-darts/logic.js:

canvas width: DART_IMAGE_SOURCE_WIDTH
canvas height: DART_IMAGE_SOURCE_HEIGHT
tip y-position: DART_IMAGE_TIP_Y
tip x-position: 0

The script estimates the tip from the leftmost visible alpha band. This is appropriate for the current Dart assets because every Dart points left and uses transparency around the graphic.