← Back to Skills Marketplace
photo-alchemy
by
Harold Martin
· GitHub ↗
· v1.0.0
· MIT-0
88
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install photo-alchemy
Description
Transform any photo into surrealist AI art. Uses Claude to write a story about your photo, then Gemini generates a reimagined version in one of 35+ visual st...
Usage Guidance
Things to consider before installing/running this skill:
- Registry metadata is incomplete: SKILL.md requires ANTHROPIC_API_KEY and GEMINI_API_KEY and uses a local DB and launchd, but the registry entry lists none — treat the package as only partially described.
- Do not blindly run the recommended 'curl … | sh' installer. Inspect the install script (uvx.sh/imagemine/install.sh) before executing. Prefer manual installation or a checked package from a trusted source.
- The tool sends your photos (and generated prompts) to external APIs (Anthropic and Google). If your photos contain sensitive people/data, that will be transmitted to third parties.
- The skill saves API keys and run metadata to ~/.imagemine.db by default. Verify how the DB is protected (file permissions, whether secrets are encrypted) and consider using environment variables or a secure credential store instead of saving keys to disk.
- The Photos integration reads face-detection names and can write back to Shared Albums and create a launchd job. Review and confirm all permissions, and inspect the generated launchd plist before loading it.
- If you want to proceed: (1) inspect the GitHub repo referenced in the SKILL.md (https://github.com/hbmartin/imagemine) and the install script; (2) prefer using ephemeral or limited-scope API keys for testing; (3) avoid enabling scheduled launchd runs until you audit behavior; (4) consider running the tool on non-sensitive images first.
If you want, I can: (a) fetch and summarize the installer script and repo README for additional checks (if you provide a URL you trust), or (b) show the likely launchd plist fields and what they mean so you can audit them before enabling scheduling.
Capability Assessment
Purpose & Capability
The SKILL.md clearly requires Anthropic and Google Gemini API keys and integrates deeply with macOS Photos and launchd, which is coherent with the described functionality. However, the registry metadata declares no required env vars or config paths — that omission is inconsistent and misleading. Asking for Photos access, face-detection names, and the ability to write back to albums fits the feature set but should have been declared up-front.
Instruction Scope
The runtime instructions direct the agent to: read macOS Photos albums (including face-detection names/people), resize images, send images to external APIs (Anthropic/Claude and Google/Gemini), write generated images back into Photos shared albums, write a local SQLite DB (~/.imagemine.db) containing run metadata and saved API keys, and optionally create a launchd plist for scheduled runs. These actions go beyond simple local image editing and carry privacy implications. They are generally coherent with the advertised features but are not limited to safe/local-only operations and are not fully declared in the registry metadata.
Install Mechanism
The registry lists no install spec, but SKILL.md suggests a one-liner 'uvx imagemine' and a permanent install via 'curl -LsSf uvx.sh/imagemine/install.sh | sh'. Piping a remote installer to sh is a high-risk pattern because it executes remote code without local review. The host uvx.sh is not documented in registry metadata; the install approach is therefore disproportionate and risky.
Credentials
The tool legitimately needs ANTHROPIC_API_KEY and GEMINI_API_KEY to call the services it claims to use. However, the skill stores keys in a local SQLite DB (~/.imagemine.db) by default (DB → env → prompt resolution order), which may store secrets in plaintext and increases exposure. The SKILL.md also accesses Photos face-detection metadata (PII) and will transmit images and derived prompts to external APIs — appropriate for the feature but privacy-sensitive and should be clearly declared in registry metadata.
Persistence & Privilege
The skill does not set always:true. It does, however, provide an option to install a launchd agent (writes ~/Library/LaunchAgents/imagemine.plist and instructs using launchctl) so it can run periodically and generate/upload images automatically. That behavior is coherent with the 'screensaver' feature but increases the blast radius (scheduled, autonomous uploads). Users should review generated plist contents and the scheduling choice before enabling.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install photo-alchemy - After installation, invoke the skill by name or use
/photo-alchemy - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of photo-alchemy.
- Instantly transform photos into surrealist AI art using an automated Claude + Gemini pipeline.
- Deep integration with Apple Photos: select photos from albums, save AI art back, manage character mappings, and schedule auto-generation for Apple TV screensavers.
- 35+ built-in artistic visual styles, with interactive management and blending.
- Flexible configuration, API key setup, detailed run history, and scripting features.
- Core functionality supported on all platforms; Apple Photos features require macOS.
Metadata
Frequently Asked Questions
What is photo-alchemy?
Transform any photo into surrealist AI art. Uses Claude to write a story about your photo, then Gemini generates a reimagined version in one of 35+ visual st... It is an AI Agent Skill for Claude Code / OpenClaw, with 88 downloads so far.
How do I install photo-alchemy?
Run "/install photo-alchemy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is photo-alchemy free?
Yes, photo-alchemy is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does photo-alchemy support?
photo-alchemy is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created photo-alchemy?
It is built and maintained by Harold Martin (@hbmartin); the current version is v1.0.0.
More Skills