← 返回 Skills 市场
165
总下载
0
收藏
0
当前安装
12
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install visual-references - 安装完成后,直接呼叫该 Skill 的名称或使用
/visual-references触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 165 次。
如何安装 Visual References?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install visual-references」即可一键安装,无需额外配置。
Visual References 是免费的吗?
是的,Visual References 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Visual References 支持哪些平台?
Visual References 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Visual References?
由 vdKroon(@vdkroon)开发并维护,当前版本 v2.0.4。
推荐 Skills