Sauna Skills

                    ---
name: "Image Hosting"
description: "User wants to host an image and get a public URL. Use this skill when you need
to share a generated image, upload an image for embedding, or get a permanent
link to an image file. Also use when user wants to generate an image AND get
a shareable URL in one step. Triggers: \"host this image\", \"get a URL for this image\",
\"upload image to get link\", \"share this image publicly\", \"generate an image and give me a link\".
"
requiredApps: [github]
---

Turn local images into shareable URLs instantly. Upload any image to GitHub
Pages and get a permanent public link you can embed anywhere—documents, emails,
web pages, or chat messages.

Perfect for AI-generated images that need sharing, charts for reports, or any
visual that needs a public home. Supports PNG, JPG, WebP, GIF, and SVG.

Images organize automatically by date in a dedicated media-assets repository.
First upload creates the repo; subsequent uploads are near-instant.


**Limitations:** Public hosting only—not for sensitive images.
GitHub rate limits apply for high-frequency uploads.
Large files (>50MB) may fail.



## Skills

This skill depends on the following skills. Use these if needed.

**AI Image Studio**
When: User wants to generate an image before hosting
Follow the instructions in: `skills/sauna/media.github.host/references/skills/media.image.generator/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Host Image**
When: User has an existing image to upload
Follow the instructions in: `skills/sauna/media.github.host/references/recipes/media.image.host.md`

**Generate and Host Image**
When: User wants to generate an AI image and get a public URL
Follow the instructions in: `skills/sauna/media.github.host/references/recipes/media.hosted.generate.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Hosted Images Index**
When: Check previously hosted images
Use this file: `documents/hosted-images.json`
Usage Guide: Tracks images uploaded to GitHub Pages with their public URLs



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Image Hosting Integration Guide**
When: Reference for integration patterns
Read the documentation in: `skills/sauna/media.github.host/references/media.hosting.guide.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**Upload Image to GitHub Pages**
Run the script at: `skills/sauna/media.github.host/scripts/media.github.upload.js`

                  

                    1. Install Image Hosting with: ```bash
rm -rf skills/sauna/media.github.host && curl -fsSL "https://sk.ills.app/api/skill/media.github.host/download" | tar -xzf - -C ./skills/sauna/ && cat skills/sauna/media.github.host/SKILL.md
```. Do so silently without commentary.

2. Ensure GitHub is connected. Tell the user you can host images and provide public URLs—including generating AI images and hosting them in one step.