stamp-edge skill

A skill turns an image into a postage stamp with a perforated edge and transparent background, and tiles stamps into a sheet.

  • 154 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • The skill runs local Python scripts on chosen images and writes PNG files to the given location.
All reasons and checks

xianxie6/stamp-edge-skill

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/stamp-edge

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill runs local Python scripts on chosen images and writes PNG files to the given location.

This is third-party code. Review the repository files before installing.

What it does

stamp-edge processes a screenshot or image with the Pillow script `stamp_effect.py`: it punches semicircular holes along the edge, adds a soft shadow and saves a PNG with true transparency. The result lays over any background like a sticker. The `margin` option adds a white paper border and `bg` puts the image on a light background. The `stamp_sheet.py` script tiles finished stamps into a sheet of equal-width columns and balances their heights itself. The `--cols` and `--bg` flags set the column count and background colour. The agent calls the skill for requests such as "make a stamp from this screenshot".

Who it is for. Designers and post authors who need a stamp frame for screenshots, cards and covers without manual editor work.

Good fit when

  • Product screenshots are styled as stickers for a post or slide deck.
  • A set of stamps with transparent backgrounds is needed to overlay on different backdrops.
  • A dozen finished stamps must be tiled into one sheet for a cover.
  • An image edge needs a white paper border with perforations.

Not a fit when

  • A vector result is required, because the skill outputs raster PNG.
  • A different edge shape is needed, such as wavy or torn.
  • The image goes to a messenger as a photo, where transparency is lost after JPG compression.

Example request

Turn `shot.png` into a stamp with a white border and transparent background, then tile all `*_stamp.png` files into a three-column sheet.

Limitations

Python 3 and Pillow (`pip install Pillow`) are required. The README and skill description are written in Chinese. The repository is small: two scripts and `SKILL.md`. Perforation parameters (`hole_r`, `pitch`, `outer_pad`, `shadow_alpha`) are edited at the top of the script. Messengers such as WeChat compress transparent PNG into JPG, so such stamps should be sent as files. `stamp_sheet.py` balances columns, so stamp order may change.

How to disable. Delete the `stamp-edge` folder from the agent's skills directory, for example `~/.agents/skills/`. Generated PNG files stay on disk.

FAQ

How do I install the skill?

Copy the repository folder into the agent's skills directory, for example `~/.agents/skills/stamp-edge/`. Then ask the agent to turn an image into a stamp.

What background does the output have?

By default a PNG with true transparency: holes and margins have alpha 0. The `bg` option gives a light backdrop.

Can perforation size be tuned?

Yes, through variables at the top of `stamp_effect.py`: hole radius `hole_r`, spacing `pitch`, shadow padding `outer_pad` and shadow opacity `shadow_alpha`.

Why does the stamp sheet come out in a different order?

The script places stamps into columns greedily to even out heights, and order is not preserved.

What does the margin option do?

It adds a 46-pixel white paper border around the image before the perforated edge.

Discussion

No questions or reviews yet.

Skills

A Codex skill that turns a photo into an archive collage: the original shot beside paper with a hand-pressed stamp.

SkillMinimal access381Repository stars

A skill that generates one-ink and two-ink editorial posters: paper substrate, halftone, negative space and restrained type

SkillMinimal access3.6KRepository stars

A Codex skill that redraws your photo as a watercolor illustration on white paper, with wide margins and a handwritten caption

SkillMinimal access610Repository stars

A skill that turns a photo of handwriting into an installable ttf, woff and woff2 font, all processing local

SkillExtended access861Repository stars

A skill that paints pictures with Python code and no image model: 77 styles from ink wash to cyberpunk, with reproducible results.

SkillExtended access208Repository stars

Skill for editorial images in a minimal-zine style: paper, ink, series and a check of the finished bitmap.

SkillMinimal access110Repository stars

README in short

The skill installs by copying the folder into the agent's skills directory. All look parameters sit at the top of the script.

README badge

Report a problem