ProcGen Toolkit

Skill axtontc/ProcGen-Toolkit

Actionable workflow for generating deterministic procedural assets (sprites, textures, layouts) using the high-performance ProcGen-Toolkit SDK.From its SKILL.md

Install

npx -y skills add axtontc/ProcGen-Toolkit

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

0 stars0 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

1.5 KB, 332 tokens by cl100k_base, as published. Nobody here has run it

ProcGen-Toolkit (Deterministic Asset Engine)

When tasked with creating procedural retro graphics, DO NOT attempt to write raw math scripts, matplotlib plots, or manually craft pixel matrices.

You MUST use the ProcGen-Toolkit SDK and CLI. This engine abstracts all math to integer indices, isolates numpy.random seeds deterministically, and handles safe multiprocessing to ensure 100% bit-for-bit reproducibility.

Workflow

1. Generating Sprite Atlases

If the user wants a batch of assets, use the procgen CLI tool to generate them:

procgen generate --type symmetry --count 50 --seed 1234 --output assets_spritesheet.png

Valid Types:

symmetry (Weapons, characters, ships)
cellular (Organic shapes, blobs)
lsystem (Trees, lightning)
random_walk (Bushes, rocks, clouds)

2. Custom Generators (SDK)

If the user wants a custom shape (e.g. Hexagonal grids or Isometric buildings), do not write a standalone script. Instead:

Extend procgen.generators.base.BaseGenerator.
Write a generate() method that uses self.rng (the isolated Generator instance).
Return a procgen.core.canvas.Canvas.
Use procgen.core.renderer.Renderer.render_to_image(canvas, scale=...) to save it via Pillow with Nearest-Neighbor scaling.

Never use global random or np.random functions. Always use self.rng.

What ships with it: 22 files

20.1 KB alongside SKILL.md, 12 of them executable