---
name: cursor-character-playground
description: Generate or adapt an offline cursor evolution playground with direct controls, keyboard access, and downloadable SVG output.
---

# Cursor Evolution Playground

Use this skill for a reusable, self-contained interactive visual study. Adapt text, palette, and parameters to the user's page while retaining the relationship between controls, visible state, and exported output.

Generate with Python 3.10+ from any working directory:

```bash
python3 /absolute/path/cursor-character-playground/scripts/generate.py -o ./index.html --era 3 --size 80
```

`--title` sets a complete plain-text heading (1–300 characters); `--accent` accepts only a six-digit hex color. `--era`: 0–5, selecting one of six independent shape studies. `--size`: 40–140 percent. Open the resulting HTML directly; append `?lang=en` for English. No external assets, server, or package installation are needed.

For changes to rendering or state behavior, read [the design notes](references/design.md), then edit `templates/index.template.html` and regenerate. Keep one live `#status` region, labeled controls, visible keyboard focus, meaningful static reduced-motion states, and SVG output consistent with the selected visual. When embedding, the frame needs script and download permissions for the intended controls and export.
