agentsclimarketplace
Sign in

Gredice game asset docs

Skill gredice/gredice/.agents/skills/gredice-game-asset-docs

Use for docs on Gredice garden game assets, 3D scene, model exports, sprite atlases, performance, quality tiers, and canvas behavior.From its SKILL.md

Install
npx -y skills add gredice/gredice --skill gredice-game-asset-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.6 KB, as published. Nobody here has run it

Gredice Game Asset Docs

Overview

Keep game and asset documentation accurate to the actual source, generated outputs, and profiling commands. Distinguish source assets from generated artifacts.

Ownership Map

Primary files and directories:

  • Garden app: apps/garden.
  • Game runtime package: packages/game.
  • Game scene root: packages/game/src/GameScene.tsx.
  • Game quality policy: packages/game/src/scene/gameQuality.ts.
  • Source Blender assets: one file per asset under assets/game-assets.
  • Game asset manifest: assets/game-assets.json.
  • Blender version marker: assets/BLENDER_VERSION.
  • Source brand/game texture examples: assets/GredicePixPal_BaseColor.png, assets/brand/gredice-logotype.svg.
  • Export scripts: assets/export.sh, assets/export.ps1.
  • Blender split/export helpers: assets/split-game-assets.py, assets/export-game-assets.py.
  • Generated GLBs: one file per asset under apps/garden/public/assets/models.
  • Generated runtime asset manifest: packages/game/src/data/gameAssetModels.generated.ts.
  • Generated model types: packages/game/src/models/GameAssets.tsx.
  • CDN asset scripts: packages/cdn/scripts.
  • Performance doc: docs/game-scene-performance.md.

Asset Pipeline

Document this pipeline exactly when it is relevant:

  1. Edit source assets under assets/game-assets and update assets/game-assets.json when adding, removing, or reprioritizing assets.
  2. Run:
pnpm generate:game-assets
  1. The script exports split GLBs to apps/garden/public/assets/models.
  2. The script runs model metadata/type generation for packages/game/src/data/gameAssetModels.generated.ts and packages/game/src/models/GameAssets.tsx.
  3. Review generated output and only commit generated artifacts when the source change requires them and they are established tracked outputs.

If the steps need to run separately:

cd assets
./export.sh
cd ..
pnpm generate:models-types

On Windows, use assets/export.ps1. Blender must be installed where WORKSPACE.md documents it. To recreate the split Blender sources from an older monolithic source, run Blender with assets/split-game-assets.py and pass -- --source /path/to/GameAssets.blend.

Decoration Sprite Atlas

The decoration atlas pipeline lives in packages/cdn/scripts and writes runtime sprite assets under apps/garden/public/assets/sprites/decorations.

Document this command when atlas assets change:

pnpm --filter @gredice/cdn run regenerate-cdn:decoration-atlas

Keep sprite names stable. The manifest uses relative input paths as sprite IDs.

Performance Documentation

Use docs/game-scene-performance.md as the current performance narrative. When updating it:

  • Date new measurements.
  • State whether numbers come from dev, production build, headless Playwright, or a real device.
  • Prefer repeated production profiling for budget decisions.
  • Record canvas backing size, reported DPR, quality tier, draw calls, triangles, FPS, long tasks, and budget pass/fail when available.
  • Separate source asset complexity from runtime render policy.
  • Identify whether changes affect shadows, DPR caps, particles, overlays, decorations, plant LOD, frame loops, or app-level providers.

Relevant profiling commands currently documented by the garden app:

cd apps/garden
pnpm run profile:game
pnpm run profile:game:ci
pnpm run profile:game:existing
pnpm run profile:game:start

Useful overrides:

GAME_PROFILE_BASE_URL=http://localhost:3001 pnpm run profile:game:existing
GAME_PROFILE_WARMUP_MS=8000 GAME_PROFILE_SAMPLE_MS=10000 pnpm run profile:game
GAME_PROFILE_FAIL_ON_BUDGET=1 pnpm run profile:game

Visual Verification

When docs claim visual behavior, verify with a browser or screenshots:

  • Garden app: https://vrt.gredice.test.
  • Debug/profile routes when available under apps/garden/app/debug.
  • Check desktop and mobile viewports when layout, canvas framing, or touch interaction is involved.
  • Confirm the canvas is nonblank and the referenced assets render.

Validation

Use targeted @gredice/game checks and garden/www typechecks when runtime behavior changes. Run asset or atlas generators only when source assets/manifests changed. Run app builds and Playwright suites only for routing, static assets, bundling, production behavior, visual behavior, or user flows. Docs-only changes need git diff --check.

Do not hand-edit generated model output unless the generator is broken and the temporary nature of the change is explicitly documented.

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.