← Back to Skills Marketplace
150
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install snap-illustrator
Description
Instantly analyze markdown articles, generate prompts, and seamlessly insert AI illustrations with zero configuration required. Supports Pollinations API (ze...
Usage Guidance
What to consider before installing:
- The core code (scripts/generate.mjs) is small and implements the advertised behavior: it tries Pollinations (unauthenticated) and falls back to HuggingFace if an HF token is available.
- However, the registry metadata declaring HF_TOKEN as required is inconsistent with the SKILL.md's zero‑config promise — don't assume you must supply a token to use the skill.
- The runtime instructions tell the agent to edit the skill's SKILL.md to store an HTTP proxy and to reuse it automatically later. Be cautious: this persists configuration into the skill bundle and enables future automatic behavior without explicit per‑run consent.
- If asked for a HuggingFace token, only provide it if you trust the skill and understand that the script will use it to call HuggingFace APIs; avoid pasting secrets into chat. Prefer to run the Node script yourself locally so you control where tokens are stored.
- If you install: (1) review/approve any changes before the skill edits files, (2) verify that the skill will not store your token unencrypted in global config unless you explicitly ask, and (3) consider running the included script manually in a sandboxed environment to verify outputs first.
- If you want to proceed, ask the author to remove HF_TOKEN from the 'required' metadata (make it optional/fallback) and to stop recommending editing SKILL.md for proxy storage; store per‑user proxy settings in a clearly scoped config with explicit user consent instead.
Capability Analysis
Type: OpenClaw Skill
Name: snap-illustrator
Version: 1.0.5
The skill is designed to automate the insertion of AI-generated images into Markdown files using Pollinations.ai or HuggingFace. The Node.js script (scripts/generate.mjs) and the agent instructions (SKILL.md) align with the stated purpose, using standard API calls and environment variables for authentication without any evidence of data exfiltration, obfuscation, or unauthorized execution.
Capability Assessment
Purpose & Capability
The SKILL.md repeatedly promotes a zero‑config flow using the unauthenticated Pollinations endpoint, yet the registry metadata marks HF_TOKEN as a required environment variable. Requesting HF_TOKEN as 'required' is disproportionate given the primary flow does not need it; the included script only uses HF_TOKEN as a fallback or from a config file.
Instruction Scope
Instructions correctly restrict generation to the provided markdown and running the bundled Node script, but they also tell the agent to modify the skill's SKILL.md frontmatter to persist an HTTP proxy and to automatically reuse that proxy in subsequent runs. That instructs the agent to edit the skill bundle on disk and to silently apply stored settings later, which broadens scope beyond simple image generation.
Install Mechanism
There is no install spec and only a small Node script is included. The skill requires the 'node' binary but does not download code from external URLs or perform any extract/install steps — this is low risk from an installation perspective.
Credentials
The skill's registry metadata lists HF_TOKEN as required, but the SKILL.md and script treat HF_TOKEN as optional/fallback. The script will also read a config file under the user's HOME (~/.config/snap-illustrator/config.json). Asking for HF_TOKEN up front (or marking it required) is disproportionate to the stated zero‑config behavior and increases credential exposure risk if users provide tokens without understanding where they will be used or stored.
Persistence & Privilege
The skill does not set always:true, but the instructions explicitly ask the agent to persist a user‑provided HTTP proxy by editing SKILL.md frontmatter so the proxy is reused automatically in future runs. Persisting settings by modifying the skill files (rather than asking the user each time or using a clearly scoped config store) is a privilege escalation in practice and should be treated cautiously.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install snap-illustrator - After installation, invoke the skill by name or use
/snap-illustrator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added a full troubleshooting section covering unauthenticated service failures, network problems (especially in Mainland China), and proxy configuration.
- Provided step-by-step guidance and user prompts in Chinese for common connectivity and token issues.
- Documented how to record and reuse supplied HTTP proxy settings via the metadata section.
- Clarified workflow and error-handling order for a smoother illustration workflow in more restrictive or variable network environments.
v1.0.4
- Updated HuggingFace token handling: Users are now instructed to provide their token as an environment variable instead of saving to disk.
- Removed explicit version field from SKILL.md to avoid redundancy.
- Refined instructions for securely handling user tokens and clarified that agents should not save tokens to disk unless users ask.
- Minor documentation cleanups for improved clarity.
v1.0.3
- Added metadata section to SKILL.md specifying environment requirements, required binaries, and config file location.
- No functional changes to skill workflow or user experience.
- Version remains at 1.0.0 in SKILL.md.
v1.0.2
- Clarified how to locate and invoke the image generation script based on the actual skill directory.
- Added a concrete example for determining the absolute path to the Node.js script using the SKILL.md file location.
- Improved instructions to ensure the script path is built relative to SKILL.md, increasing reliability across installations.
- Updated execution guidance in SKILL.md; no functional code changes.
v1.0.1
- Updated HuggingFace token configuration path from `~/.agents/skills/snap-illustrator/config.json` to `~/.config/snap-illustrator/config.json` for improved consistency.
- Documentation (SKILL.md) updated to reflect the correct config file location in the user instructions.
- Internal references and instructions now consistently point to the new configuration directory.
v1.0.0
Snap Illustrator: Instantly analyze markdown content and insert AI-generated illustrations with zero configuration.
- Supports frictionless, token-free use with Pollinations API, gracefully falling back to HuggingFace if needed.
- Auto-analyzes markdown, proposes illustration outline for user confirmation, and generates scene-specific prompts.
- Images are generated via a provided Node.js script and inserted directly into the markdown as standard image links.
- Designed for maximum automation—no setup required unless the free service is unavailable.
Metadata
Frequently Asked Questions
What is Snap Illustrator?
Instantly analyze markdown articles, generate prompts, and seamlessly insert AI illustrations with zero configuration required. Supports Pollinations API (ze... It is an AI Agent Skill for Claude Code / OpenClaw, with 150 downloads so far.
How do I install Snap Illustrator?
Run "/install snap-illustrator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Snap Illustrator free?
Yes, Snap Illustrator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Snap Illustrator support?
Snap Illustrator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Snap Illustrator?
It is built and maintained by wysaid (@wysaid); the current version is v1.0.5.
More Skills