← Back to Skills Marketplace
vdkroon

Visual References

by vdKroon · GitHub ↗ · v2.0.4 · MIT-0
cross-platform ✓ Security Clean
165
Downloads
0
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install visual-references
Description
Search and download visual reference images from Pexels to inspire image or video generation. Use when you need style references, mood boards, composition or...
Usage Guidance
This skill appears to do what it says: it uses your PEXELS_API_KEY to call the Pexels API and download reference images. Before installing, consider: (1) Provide only a Pexels API key — the skill does not request other credentials. (2) The SKILL.md insists on using /tmp/visual-refs and the script cleans files named ref_* there; avoid using that same directory for unrelated files to prevent accidental deletion. (3) The docs instruct the agent not to 'read' or manually review references and to pass them directly into the generator — if you want a human or policy review of downloaded images (e.g., for licensing or objectionable content), use the alternative flow where the user picks references. (4) Verify the Pexels API key permissions and rate limits for your account (demo plan limits noted in docs). (5) Note the small implementation mismatch: metadata mentions the 'requests' package though the script uses urllib; that's likely harmless but indicates the package metadata could be stale. If those considerations are acceptable, the skill is coherent and proportionate to its purpose.
Capability Analysis
Type: OpenClaw Skill Name: visual-references Version: 2.0.4 The visual-references skill is a legitimate tool for searching and downloading images from the Pexels API. The Python script (visual_ref.py) uses standard libraries for network requests and file management, with clear logic for downloading images to a temporary directory (/tmp/visual-refs) and generating metadata. The instructions in SKILL.md are focused on optimizing the agent's workflow and token usage, and no indicators of data exfiltration, malicious execution, or harmful prompt injection were identified.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior. The script and SKILL.md call the Pexels API and download images. Requested binary (python3) and required env var (PEXELS_API_KEY) are appropriate and proportional to the stated goal.
Instruction Scope
Runtime instructions stay within the purpose (search -> download -> pass as input_images). Two notable policy-like requirements are enforced in the docs: always use /tmp/visual-refs (the script also auto-cleans that folder) and the default flow tells the agent not to 'read' or manually review references but to pass all downloaded refs directly into generate_image. These are operational constraints (not security issues per se) but could cause collisions if another process used the same path and may reduce human review of licensing or content before generation.
Install Mechanism
No install spec — instruction-only plus a small Python script. The code uses only stdlib urllib and writes files under the declared output directory. No downloads/installers or third-party package pulls are present in the package.
Credentials
The only environment variable required is PEXELS_API_KEY, which is appropriate. Minor mismatch: SKILL.md metadata lists a pip dependency 'requests', but the included script uses urllib (no import of requests). This is an implementation inconsistency (not an unexplained credential request).
Persistence & Privilege
Skill is not always-enabled and does not request system-level persistence. It writes output only to the configured output directory and a metadata JSON file in that directory; no modifications to other skills or global agent settings are present.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install visual-references
  3. After installation, invoke the skill by name or use /visual-references
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.4
Fix: send references ONCE in a single message, prevent duplicate sends
v2.0.3
Fix: mandate single output dir /tmp/visual-refs to prevent folder proliferation across searches
v2.0.2
Fix: clean previous refs before each search to prevent accumulation across multiple queries
v2.0.1
Fix: correct script path to workspace/skills, add User-Agent header for Pexels API
v2.0.0
Switched from Unsplash to Pexels API. Better image quality. Requires PEXELS_API_KEY env var.
v1.6.0
Add alternative flow: user picks references when explicitly requested
v1.5.0
Pass all references as input_images (no manual evaluation). Random page + shuffle for variety.
v1.4.0
Mandatory: pass best reference as input_images when generating after searching
v1.3.0
Add usage limits: max 2 searches per task, --count 3 default
v1.2.0
Full English translation (SKILL.md + script). Declared UNSPLASH_ACCESS_KEY as required env var.
v1.1.0
Declare UNSPLASH_ACCESS_KEY as required env var in metadata, fix SKILL.md prerequisite section
v1.0.0
- Primera versión del skill visual-references. - Permite buscar y descargar imágenes de referencia visual desde Unsplash, útil antes de generar imágenes o vídeos. - Incluye triggers como "busca referencias" o "inspírate en" para facilitar su invocación según el brief creativo. - Explica claramente cuándo usar (o no usar) el skill, ejemplos de queries efectivos, y describe el flujo recomendado. - El script soporta opciones de cantidad, formato, carpeta de salida y modo solo-listado. - Genera archivos con metadatos y requiere atribución conforme a las normas de Unsplash.
Metadata
Slug visual-references
Version 2.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 12
Frequently Asked Questions

What is Visual References?

Search and download visual reference images from Pexels to inspire image or video generation. Use when you need style references, mood boards, composition or... It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.

How do I install Visual References?

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

Is Visual References free?

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

Which platforms does Visual References support?

Visual References is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Visual References?

It is built and maintained by vdKroon (@vdkroon); the current version is v2.0.4.

💬 Comments