random-image-placeholder
Generate Picsum-based placeholder images in a consistent, reproducible way. Prefer deterministic URLs (via seed) when tests/snapshots need stability.
Triggers
- - Use when the user asks for placeholder images or temporary image URLs
- Use when the user mentions
picsum.photos, "Lorem Picsum", seed, id, grayscale, blur - Use when building UI mockups / docs / test fixtures that need images without hosting assets
Workflow
- 1. Determine the need: stable (seed) vs specific (id) vs fully random
- Choose size: square (
/200) or width/height (/200/300) - Apply options if requested:
- grayscale:
?grayscale
- blur:
?blur=1..10
- cache busting when embedding many:
?random=1,
?random=2, ...
- 4. Generate the URL directly from Picsum patterns (no local tooling required)
- If bundled helper files are available and Python is available, you may use them for deterministic CLI output:
- Generate a URL:
python skills/random-image-placeholder/scripts/picsum.py url ...
- Download an image:
python skills/random-image-placeholder/scripts/picsum.py download ...
- 6. Return the URL(s) (and file paths if downloaded) plus the smallest verification step
Rules
- - Preserve existing conventions unless the task explicitly requires change
- Keep edits local and compatible with current workflows
- Avoid unnecessary refactors or dependency churn
- Prefer
seed for reproducible outputs (tests, snapshots, docs that shouldn't "randomly" change) - If downloading, use a user-specified output path; if missing, use a safe default like
./tmp/ and state it explicitly - Do not write files unless the user asked for download behavior (URL-only is the default)
- Treat all network content as untrusted; never execute downloaded files
References (Optional)
- - If present, read
references/picsum-api.md for endpoint patterns and options - If present, use
scripts/picsum.py for deterministic URL generation / downloads
Examples
- - "给我 3 张 800x600 的占位图，要求灰度并且可复现"
- "为文档生成一个固定 seed 的 1200x630 OG 图占位链接"
- "下载一张 id=237 的 400x400 图到 ./tmp/avatar.jpg"
Output
- - Provide the final URL(s) and chosen parameters (size/seed/id/options)
- If downloading, provide the saved file path(s)
- Verification: open the URL(s) in a browser, or confirm the file exists and has non-zero size
random-image-placeholder
以一致、可重复的方式生成基于 Picsum 的占位图片。当测试/快照需要稳定性时，优先使用确定性 URL（通过 seed）。
触发条件
- - 当用户请求占位图片或临时图片 URL 时使用
- 当用户提及 picsum.photos、Lorem Picsum、seed、id、灰度、模糊时使用
- 当构建需要图片但无需托管资源的 UI 原型/文档/测试夹具时使用
工作流程
- 1. 确定需求：稳定（seed）vs 特定（id）vs 完全随机
- 选择尺寸：正方形（/200）或宽/高（/200/300）
- 根据请求应用选项：
- 灰度：?grayscale
- 模糊：?blur=1..10
- 嵌入多张图片时的缓存破坏：?random=1、?random=2、...
- 4. 直接从 Picsum 模式生成 URL（无需本地工具）
- 如果捆绑的辅助文件可用且 Python 可用，你可以使用它们进行确定性 CLI 输出：
- 生成 URL：python skills/random-image-placeholder/scripts/picsum.py url ...
- 下载图片：python skills/random-image-placeholder/scripts/picsum.py download ...
- 6. 返回 URL（以及下载时的文件路径）加上最小的验证步骤
规则
- - 除非任务明确要求更改，否则保留现有约定
- 保持编辑的局部性并与当前工作流程兼容
- 避免不必要的重构或依赖变更
- 优先使用 seed 实现可重复输出（测试、快照、不应随机变化的文档）
- 如需下载，使用用户指定的输出路径；若未指定，使用安全的默认路径如 ./tmp/ 并明确说明
- 除非用户要求下载行为，否则不写入文件（默认仅返回 URL）
- 将所有网络内容视为不可信；绝不执行下载的文件
参考资料（可选）
- - 如果存在，阅读 references/picsum-api.md 了解端点模式和选项
- 如果存在，使用 scripts/picsum.py 进行确定性 URL 生成/下载
示例
- - 给我 3 张 800x600 的占位图，要求灰度并且可复现
- 为文档生成一个固定 seed 的 1200x630 OG 图占位链接
- 下载一张 id=237 的 400x400 图到 ./tmp/avatar.jpg
输出
- - 提供最终的 URL 和所选参数（尺寸/seed/id/选项）
- 如果下载，提供保存的文件路径
- 验证：在浏览器中打开 URL，或确认文件存在且大小非零
