\r \r

Circle PNG Image\r

\r

What This Skill Does\r

\r Use this skill to turn any PNG image into a circular PNG with transparency outside the circle. It is intended for avatars, profile photos, icons, and other round image assets.\r \r The default behavior is:\r \r

1. Open the input PNG.\r
2. Convert it to RGBA so transparency is preserved.\r
3. Center-crop the image to a square using the shorter side.\r
4. Apply a circular alpha mask.\r
5. Save the result as a PNG.\r \r

Quick Start\r

\r Run the helper script:\r \r

python scripts/circle_png.py input.png output.png\r
```\r
\r
If the system uses `python3`:\r
\r
```bash\r
python3 scripts/circle_png.py input.png output.png\r
```\r
\r
## Options\r
\r
Set an exact output size:\r
\r
```bash\r
python scripts/circle_png.py input.png output.png --size 512\r
```\r
\r
Preserve the entire image by padding it to a square before applying the circular mask:\r
\r
```bash\r
python scripts/circle_png.py input.png output.png --fit contain\r
```\r
\r
Overwrite an existing output file:\r
\r
```bash\r
python scripts/circle_png.py input.png output.png --force\r
```\r
\r
## Dependency\r
\r
The script requires Pillow. If it is missing, install it in the active Python environment:\r
\r
```bash\r
python -m pip install pillow\r
```\r
\r
Prefer a virtual environment when modifying a project:\r
\r
```bash\r
python -m venv .venv\r
.venv/Scripts/python -m pip install pillow\r
.venv/Scripts/python scripts/circle_png.py input.png output.png\r
```\r
\r
On macOS or Linux, use `.venv/bin/python` instead of `.venv/Scripts/python`.\r
\r
## Agent Instructions\r
\r
When the user asks to make a PNG circular:\r
\r
1. Confirm the input image path and desired output path. If no output is specified, use the input name with `-circle.png` appended before the extension.\r
2. Use `scripts/circle_png.py` to generate the output.\r
3. Use `--fit cover` by default for avatar-style results.\r
4. Use `--fit contain` when the user says to preserve the full image.\r
5. Use `--size` only when the user asks for a specific output dimension.\r
6. Never overwrite an existing output unless the user explicitly asks or `--force` is appropriate.\r
\r
## Notes\r
\r
- Output is always PNG with an alpha channel.\r
- Non-square inputs are centered automatically.\r
- The circle touches the output square's edges.\r