Agent-Skills.md

Agent Skills: GIIL — Get Image [from] Internet Link

Get Image [from] Internet Link - Zero-setup CLI for downloading full-resolution images from iCloud, Dropbox, Google Photos, and Google Drive share links. Four-tier capture strategy, browser automation, HEIC conversion, album support. Node.js/Playwright.

UncategorizedID: dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/giil

Repository

dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
DicklesworthstoneLicense: NOASSERTION
6713

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/tree/HEAD/skills/giil

Skill Files

Browse the full folder contents for giil.

Download Skill

Loading file tree…

skills/giil/SKILL.md

Skill Metadata

Name
giil
Description
>-
<!-- TOC: Quick Start | THE EXACT PROMPT | Supported Platforms | Output Modes | References -->

GIIL — Get Image [from] Internet Link

Core Capability: Zero-setup CLI that downloads full-resolution images from cloud photo shares. The missing link between iPhone screenshots and remote AI coding sessions.

Quick Start

# Install
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/giil/main/install.sh?v=3.0.0" | bash

# Download single image
giil "https://share.icloud.com/photos/02cD9okNHvVd-uuDnPCH3ZEEA"

# JSON output (best for AI workflows)
giil "https://share.icloud.com/photos/..." --json

# Download entire album
giil "https://share.icloud.com/photos/..." --all --output ~/album

Note: First run downloads Playwright Chromium (~200MB, cached in ~/.cache/giil/).

THE EXACT PROMPT — Remote AI Debugging Workflow

iPhone Screenshot → iCloud Sync → Photos.app Share Link → Paste to SSH → giil Downloads → AI Analyzes

# Get image for AI analysis
IMAGE_PATH=$(giil "https://share.icloud.com/photos/XXX" --output /tmp 2>/dev/null)
# AI can now read the image at $IMAGE_PATH

THE EXACT PROMPT — Output Modes

# Default: file path to stdout
giil "https://share.icloud.com/photos/XXX"
# stdout: /current/dir/icloud_20240115_143245.jpg

# JSON mode (best for programmatic use)
giil "..." --json
# {"ok": true, "path": "/absolute/path/...", "width": 4032, "height": 3024}

# Base64 mode (no file saved)
giil "..." --base64 | base64 -d > image.jpg

# URL-only mode (get CDN URL without downloading)
giil "..." --print-url

Supported Platforms

| Platform | URL Patterns | Browser Required | |----------|--------------|------------------| | iCloud | share.icloud.com/photos/* | Yes | | Dropbox | dropbox.com/s/*, dropbox.com/scl/fi/* | No (fast) | | Google Photos | photos.app.goo.gl/*, photos.google.com/share/* | Yes | | Google Drive | drive.google.com/file/d/* | Yes |

Dropbox Fast Path: Direct curl download, 1-2 seconds, no browser overhead.

Essential Options

| Flag | Description | |------|-------------| | --output DIR | Output directory (default: .) | | --json | Output JSON metadata | | --all | Download all photos from album | | --preserve | Keep original bytes (skip compression) | | --convert FMT | Convert to: jpeg, png, webp | | --quality N | JPEG quality 1-100 (default: 85) | | --base64 | Output base64 to stdout | | --timeout N | Page load timeout in seconds (default: 60) | | --debug | Save debug artifacts on failure |

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 10 | Network error | | 11 | Auth required (link not public) | | 12 | Not found (expired/deleted) | | 13 | Unsupported type (video, doc) |

References

| Topic | Reference | |-------|-----------| | Full command reference | COMMANDS.md | | Four-tier capture strategy | CAPTURE-STRATEGY.md | | Troubleshooting | TROUBLESHOOTING.md |