메뉴
Search the web for images (photos, logos, graphics) and download them with Typst embedding code. Use when the user needs real-world images, company logos, or existing graphics for documents.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Create new documents in any format — Beamer slides, Typst documents, or Quarto slides. Autonomous pipeline from prompt to publication-quality output.
Syntax guide and ecosystem reference for writing Typst (.typ) files. Use this skill when writing, editing, or debugging Typst documents. Covers core syntax, common errors, packages, and best practices.
Master pipeline — compile, review, fix, and finalize any document. Auto-detects format and runs the full quality loop.
Stage, commit, create PR, and merge to main. Use for the standard commit-PR-merge cycle.
Compile any supported file type. Detects format (.typ, .qmd, .py) and runs appropriate build command.
Show current context status and session health. Use to check how much context has been used, whether auto-compact is approaching, and what state will be preserved.
| name | image-search |
| description | Search the web for images (photos, logos, graphics) and download them with Typst embedding code. Use when the user needs real-world images, company logos, or existing graphics for documents. |
| allowed-tools | Bash |
| argument-hint | <query> [--logo] [--stock] [--url <url>] [--dir images] [-n 1] [--size large|medium|icon] [--type photo|clipart|face|lineart] |
Parse $ARGUMENTS into flags for the bundled script and run it in one Bash call. The script handles search, download, filename generation, and Typst code output.
Flags: query (positional), --logo, --stock, --url <url>, -d dir, -o output, -n count, --size, --type, --width, --caption "..."
Pass --typst when generating images for Typst documents (the typical case). If --output/-o is not given, omit it (script auto-generates from query + dir).
Run exactly one command:
SERPAPI_KEY="$SERPAPI_KEY" uv run --script {baseDir}/scripts/image_search.py "<query>" --typst [other flags...]
If SERPAPI_KEY is empty in this shell, read it directly from fish universal variables (avoids shell greeting pollution): `printf '%b' "$(sed -n 's/.*SERPAPI_KEY://p' ~/.config/fish/fish_variables)"`.
For --stock mode, also forward Unsplash/Pexels keys if available:
SERPAPI_KEY="$SERPAPI_KEY" UNSPLASH_ACCESS_KEY="$UNSPLASH_ACCESS_KEY" PEXELS_API_KEY="$PEXELS_API_KEY" uv run --script {baseDir}/scripts/image_search.py "<query>" --stock --typst [other flags...]
Print the script's stdout to the user. Done.
| Mode | Flag | Behavior |
|---|---|---|
| Image search (default) | none | SerpAPI -> DuckDuckGo fallback -> download best match |
| Logo lookup | --logo | Logo.dev -> image search fallback |
| Stock photos | --stock | Unsplash -> Pexels -> image search fallback (license-clear) |
| Direct URL | --url <url> | Download image directly from URL |
Zero API keys required — works via DuckDuckGo by default. Each key unlocks a better tier:
| Key | Purpose |
|---|---|
SERPAPI_KEY | Google Images (best quality) |
UNSPLASH_ACCESS_KEY | Stock photos via Unsplash |
PEXELS_API_KEY | Stock photos via Pexels |