← Back to Skills Marketplace
tobewin

Perler Pattern

by ToBeWin · GitHub ↗ · v1.2.0 · MIT-0
cross-platform ✓ Security Clean
169
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install perler-pattern
Description
Convert any image into a perler/hama/fuse bead pattern. 把任意图片转换成精美的拼豆图纸。Use when the user wants to generate a bead pattern from a photo, image, or URL. Outpu...
Usage Guidance
This skill appears coherent and implements what it claims, but take the usual precautions before running code that will install packages and process files: 1) Review the provided Python script (it will run on your system). 2) Run it in a controlled environment or virtualenv to avoid unexpected system-wide package changes. 3) When supplying OUTPUT_DIR, choose a dedicated directory (avoid system paths). 4) If you provide an image URL, ensure it’s from a trusted source (the skill may fetch that URL). 5) Expect pip to download OpenCV/Pillow/numpy from PyPI at runtime — this is normal but does require network access. If any of these behaviors are unacceptable, don’t run the script or request the maintainer to provide a packaged install or explicit dependency list.
Capability Analysis
Type: OpenClaw Skill Name: perler-pattern Version: 1.2.0 The skill bundle is a legitimate tool for converting images into perler bead patterns. It uses standard Python libraries (OpenCV, PIL, NumPy) to perform offline background removal, color quantization, and file generation (SVG, HTML, PNG). No evidence of data exfiltration, malicious execution, or prompt injection was found; the code logic is transparent and aligns perfectly with the stated purpose in SKILL.md and the reference documentation.
Capability Assessment
Purpose & Capability
The name/description (convert images to perler/bead patterns) aligns with the provided instructions and embedded Python script. Required runtime (python3 + common imaging libraries) is appropriate and expected for this functionality.
Instruction Scope
The SKILL.md contains a full Python script that performs offline background removal (GrabCut) and pattern generation, and it instructs the agent to install OpenCV/Pillow/numpy if missing. The instructions do not request unrelated files, secrets, or external endpoints beyond image source URLs supplied by the user. Minor inconsistency: the skill states "fully offline, no API" for processing (true) but the runtime installs use pip which will fetch packages from PyPI (network activity to install dependencies).
Install Mechanism
This is an instruction-only skill with no install spec. It runs in-process pip installs (pip3 install opencv-python-headless Pillow numpy) if missing. Using pip at runtime is standard here but does involve network access to PyPI; no third-party or unusual download URLs are used.
Credentials
The skill declares no required environment variables, no credentials, and no config paths. The embedded code does not reference secrets or unrelated environment variables in the provided excerpt.
Persistence & Privilege
always is false and there is no mechanism to persist or modify other skills or agent-wide settings. The script writes outputs to an OUTPUT_DIR specified by the agent/user (normal for a generator).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install perler-pattern
  3. After installation, invoke the skill by name or use /perler-pattern
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
**Now includes automatic background removal for uploaded images.** - Adds fully offline background removal using GrabCut before pattern generation. - Lets you choose a dark, black, white, or custom background for the pattern. - Enlarges default color count (now up to 32 colors selectable). - Produces improved outputs: interactive HTML, print-ready SVG, 3D PNG, and bead count. - Updates and clarifies dependency checks (now requires OpenCV).
v1.1.0
perler-pattern 1.1.0 - Added interactive HTML pattern viewer with hover tooltips, color highlighting, and print support. - Outputs print-ready SVG with color codes, pixel-art PNG preview, and a detailed bead count list. - Supports Hama, Artkal, Perler, and universal palettes. - Works fully offline with zero API cost, in pure Python. - Provides bilingual (English/Chinese) interface and usage guidance.
Metadata
Slug perler-pattern
Version 1.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Perler Pattern?

Convert any image into a perler/hama/fuse bead pattern. 把任意图片转换成精美的拼豆图纸。Use when the user wants to generate a bead pattern from a photo, image, or URL. Outpu... It is an AI Agent Skill for Claude Code / OpenClaw, with 169 downloads so far.

How do I install Perler Pattern?

Run "/install perler-pattern" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Perler Pattern free?

Yes, Perler Pattern is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Perler Pattern support?

Perler Pattern is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Perler Pattern?

It is built and maintained by ToBeWin (@tobewin); the current version is v1.2.0.

💬 Comments