dart-asset-normalization

Stars10

Forks0

UpdatedMay 1, 2026 at 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.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

thomasasen

thomasasen/autodarts-xconfig

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

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.

More from this repository

same repository

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.