asset-optimization

Optimize and validate media delivery in the TotalCross Astro website. Use when adding or replacing raster images, animation, or video; changing Astro Image, Picture, or getImage usage; investigating asset-size or page-payload budget failures; or reviewing source-versus-generated media provenance.

Ir a la instalación

Repositorio: TotalCross/totalcross.github.io
Última actividad en el origen: 11 de agosto de 2026 a las 01:38
Idioma detectado de SKILL.md: inglés
Estrellas: 0
Forks: 2

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

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.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/TotalCross/totalcross.github.io --skill asset-optimization

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

2 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

license-validation

Validate and conservatively repair SPDX copyright and license metadata in the TotalCross website repository. Use when creating, moving, splitting, or relicensing files; when license CI fails; before closing a milestone that changes tracked files; or when ownership and REUSE mappings need review.

2026-08-10

logical-commits

Prepare coherent, reviewable Conventional Commits while preserving unrelated work in the TotalCross website repository. Use before staging or committing any repository change, when separating mixed diffs, or when recording an ExecPlan milestone or completed implementation slice.

2026-08-10

Ver todos los de este repositorio

Asset optimization

Measure generated delivery, preserve provenance, and keep optimization changes tied to the page that consumes each asset.

Workflow

Read the active ExecPlan state and inspect the current asset report before editing.

Locate page references with rg; do not scan or rewrite unrelated media.

Preserve historical src/assets/** provenance under REUSE.toml. Run the license-validation skill for new derivatives or moved files.

Prefer Astro Picture for responsive AVIF/WebP photographic content, Image for optimized local images, and getImage for CSS backgrounds. Size responsive candidates from the maximum rendered CSS width multiplied by the target device pixel ratio; provide approximately 2x coverage for important imagery when the source resolution permits it. Never upscale a low-resolution source to create a fake quality improvement: obtain a better source or constrain the rendered CSS width instead. Keep intrinsic sizes, eager-load only the LCP asset, and lazy-load below-fold images.

Replace large animated GIF delivery with WebM plus MP4 fallback and a compact poster. Record deterministic conversion commands; do not add ffmpeg to normal builds.

Complete the coherent slice before final validation. Run npm run assets:test, npm run license:check, npm run workflow:check, npm run check, one fresh npm run build, npm run assets:check, then npm run validate as required by the active milestone.

Budget policy

Treat scripts/assets/budgets.mjs as canonical. Hard limits apply to generated dist/ output and representative fallback-resource proxies. Source masters remain report-only when normal page delivery is transformed. Keep warnings visible; add a reviewed path-specific exception only when measured visual quality justifies one.