Sauna Skills

                    ---
name: "Web App Publisher"
description: "User wants to publish existing web content or HTML files to GitHub Pages.
Triggers: \"publish this to GitHub Pages\", \"deploy my HTML\", \"host this online\",
\"make this live\", \"publish to the web\"
"
requiredApps: [github]
---

Deploy existing web content to GitHub Pages. Takes a directory of HTML, CSS, JS,
and assets and publishes it as a live website with a public URL.

Handles single files or multi-file projects with assets. Updates existing
deployments automatically.


**Limitations:** Static content only—no server-side code or databases.
GitHub Pages may take 1-2 minutes to reflect changes.
This skill deploys existing content—use purpose-specific skills to build apps.



## Tasks

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

**Deploy to GitHub Pages**
When: User has web content to deploy
Follow the instructions in: `skills/sauna/web.github.publisher/references/recipes/web.github.deploy.md`



## State

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

**Published Content**
When: Check previously published sites for reference or updates
Use this file: `documents/media/published/index.md`
Usage Guide: Track published content (letters, sites, etc.) with their URLs and publication dates. Each entry contains: type (letter/site), title, url, publishedAt (ISO date), and type-specific metadata (style, author for letters; framework for sites). Append new entries on publish; update existing entries by matching slug on re-publish.

                  

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

2. Ensure GitHub is connected for publishing. Ask the user what files or directory they want to deploy.