{"skill":{"slug":"circle-png-image","displayName":"circle-png-image","summary":"Convert PNG images into circular PNG avatars with transparent corners. Use when the user asks to crop, mask, cut out, or convert a PNG image into a circle.","description":"---\r\nname: circle-png-image\r\ndescription: Convert PNG images into circular PNG avatars with transparent corners. Use when the user asks to crop, mask, cut out, or convert a PNG image into a circle.\r\nversion: 1.0.0\r\nmetadata:\r\n  openclaw:\r\n    requires:\r\n      anyBins:\r\n        - python\r\n        - python3\r\n    install:\r\n      - kind: uv\r\n        package: pillow\r\n    emoji: \"⭕\"\r\n---\r\n\r\n# Circle PNG Image\r\n\r\n## What This Skill Does\r\n\r\nUse 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\n\r\nThe default behavior is:\r\n\r\n1. Open the input PNG.\r\n2. Convert it to RGBA so transparency is preserved.\r\n3. Center-crop the image to a square using the shorter side.\r\n4. Apply a circular alpha mask.\r\n5. Save the result as a PNG.\r\n\r\n## Quick Start\r\n\r\nRun the helper script:\r\n\r\n```bash\r\npython scripts/circle_png.py input.png output.png\r\n```\r\n\r\nIf the system uses `python3`:\r\n\r\n```bash\r\npython3 scripts/circle_png.py input.png output.png\r\n```\r\n\r\n## Options\r\n\r\nSet an exact output size:\r\n\r\n```bash\r\npython scripts/circle_png.py input.png output.png --size 512\r\n```\r\n\r\nPreserve the entire image by padding it to a square before applying the circular mask:\r\n\r\n```bash\r\npython scripts/circle_png.py input.png output.png --fit contain\r\n```\r\n\r\nOverwrite an existing output file:\r\n\r\n```bash\r\npython scripts/circle_png.py input.png output.png --force\r\n```\r\n\r\n## Dependency\r\n\r\nThe script requires Pillow. If it is missing, install it in the active Python environment:\r\n\r\n```bash\r\npython -m pip install pillow\r\n```\r\n\r\nPrefer a virtual environment when modifying a project:\r\n\r\n```bash\r\npython -m venv .venv\r\n.venv/Scripts/python -m pip install pillow\r\n.venv/Scripts/python scripts/circle_png.py input.png output.png\r\n```\r\n\r\nOn macOS or Linux, use `.venv/bin/python` instead of `.venv/Scripts/python`.\r\n\r\n## Agent Instructions\r\n\r\nWhen the user asks to make a PNG circular:\r\n\r\n1. 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\n2. Use `scripts/circle_png.py` to generate the output.\r\n3. Use `--fit cover` by default for avatar-style results.\r\n4. Use `--fit contain` when the user says to preserve the full image.\r\n5. Use `--size` only when the user asks for a specific output dimension.\r\n6. Never overwrite an existing output unless the user explicitly asks or `--force` is appropriate.\r\n\r\n## Notes\r\n\r\n- Output is always PNG with an alpha channel.\r\n- Non-square inputs are centered automatically.\r\n- The circle touches the output square's edges.\r\n","tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":338,"installsAllTime":0,"installsCurrent":0,"stars":1,"versions":2},"createdAt":1777775826288,"updatedAt":1778492833926},"latestVersion":{"version":"1.0.1","createdAt":1777776053049,"changelog":"No changes detected in this version.\n\n- No updates or modifications were made to the files.\n- The skill remains at version 1.0.0 with the same features and behavior.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"charmingzuo","userId":"s17c2zbswdzwygt9p5ndachbbd85zrfg","displayName":"charming.zuo","image":"https://avatars.githubusercontent.com/u/2429983?v=4"},"moderation":null}