← Back to Skills Marketplace
141
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install photo-watermark
Description
为照片添加可自定义的文字或图片水印。在处理图片、添加水印或批量处理照片时使用。支持JPG、PNG和其他常见图片格式。
Usage Guidance
Overall the package appears to implement what it claims: local watermarking and optional retouching, using standard Python imaging libraries with no network calls or credential access. Before installing or running it: 1) Inspect scripts/add_watermark.py and the is_safe_path() implementation to confirm path validation blocks undesired files (the tests reference this). 2) Note documentation/metadata inconsistencies: registry metadata lists version 1.0.5 while many docs/manifests reference v2.1.0/2.2.0 and mention an install.py that is not present — confirm you have the intended release. 3) Verify any optional dependency (opencv/numpy/scipy) is installed only if you need retouching; opencv can be large. 4) If you plan to run any curl|sh installation examples, download and review the script first (as the README suggests). 5) Run the included test_skill.py in a safe environment to validate behavior on your machine before processing important files.
Capability Analysis
Type: OpenClaw Skill
Name: photo-watermark
Version: 1.0.5
The photo-watermark skill bundle is a legitimate image processing utility for adding watermarks and performing skin retouching. The code demonstrates high security awareness, featuring a robust path validation function (is_safe_path in scripts/add_watermark.py) that prevents path traversal and restricts access to sensitive system directories. It utilizes standard libraries like Pillow, OpenCV, and NumPy for its stated functions, and the documentation (README.md, SECURITY_FIXES.md) explicitly warns users about security best practices and documents the removal of potentially risky subprocess calls. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description describe adding text/image watermarks and optional retouching; the repository contains image-processing modules (add_watermark.py, skin_retouch.py, aspect_converter.py, utils/config) and examples that align with that purpose. Declared optional dependencies (Pillow, opencv, numpy, scipy) are appropriate for the claimed features.
Instruction Scope
SKILL.md instructs running local Python scripts (scripts/add_watermark.py) on user-supplied image files (single or glob patterns). The instructions reference only local files and example docs; they do not instruct reading unexpected system data or sending data externally.
Install Mechanism
There is no automated install spec in the registry entry (instruction-only skill). README suggests manual pip install of requirements; optional curl example is accompanied by a warning to inspect scripts before running. No evidence of downloads from untrusted URLs or archive extraction in the provided files.
Credentials
Skill requires no environment variables or credentials. Optional dependencies are relevant to image processing. There are no requests for unrelated secrets or system config paths in the provided files and docs.
Persistence & Privilege
Skill is not 'always: true' and uses standard local scripts. It does not request elevated privileges or claim to modify other skills or system-wide settings. File I/O is limited to user-specified input/output paths.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install photo-watermark - After installation, invoke the skill by name or use
/photo-watermark - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added SECURITY_COMPLIANCE.md for improved security documentation.
- Added backup file install.py.bak.
- Added compiled Python file scripts/__pycache__/add_watermark.cpython-314.pyc.
- Removed install.py.
v1.0.4
- Added aspect ratio converter utility script: scripts/aspect_converter.py
- New usage sample for 9:16 aspect ratio conversion: examples/convert-to-9-16.md
- Included final release documentation: FINAL_RELEASE.md
v1.0.3
- Added project and release metadata files: CLAWHUB_READY.md, RELEASE_MANIFEST.md, and clawhub.yaml
- Introduced install.py for installation support
- Added test_skill.py to enable testing of the skill
v1.0.2
- Added CHANGELOG.md for tracking updates.
- Added mobile photo editing guide: examples/mobile-photo-guide.md.
- Added skin retouching guide: examples/skin-retouch-guide.md.
- Introduced skin retouching script: scripts/skin_retouch.py.
v1.0.1
- Added SECURITY_FIXES.md to document security-related updates.
- Added compiled Python bytecode file scripts/__pycache__/add_watermark.cpython-314.pyc.
v1.0.0
Initial release of photo-watermark.
- Add customizable text or image watermarks to photos.
- Supports JPG, PNG, and other common image formats.
- Allows batch processing of multiple images.
- Offers flexible positioning, opacity, scaling, font size, color, and rotation options.
- Provides command-line usage for quick integration into workflows.
Metadata
Frequently Asked Questions
What is photo-watermark?
为照片添加可自定义的文字或图片水印。在处理图片、添加水印或批量处理照片时使用。支持JPG、PNG和其他常见图片格式。 It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.
How do I install photo-watermark?
Run "/install photo-watermark" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is photo-watermark free?
Yes, photo-watermark is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does photo-watermark support?
photo-watermark is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created photo-watermark?
It is built and maintained by x0cd (@nianxiushi); the current version is v1.0.5.
More Skills