Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

host

/host

Wysyła pliki na Cloudflare R2 i zwraca publiczny adres do udostępnienia, z automatycznym slugiem, kopiowaniem do schowka i historią hostowania, dla dowolnego typu pliku.

Licencja
MIT
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
3
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 3 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/history.sh, scripts/host.sh, scripts/setup.sh

Co robi i kiedy

Wysyła pliki na Cloudflare R2 i zwraca publiczny adres do udostępnienia, z automatycznym slugiem, kopiowaniem do schowka i historią hostowania, dla dowolnego typu pliku.

Wyzwalacze z opisu

hosthost thishost filepublishpublish thisshare this fileupload to R2make this public
Oryginalny opis (EN)

Upload files to Cloudflare R2 and return a shareable public URL. Supports any file type (HTML, images, PDFs, etc.) with automatic slug generation, clipboard copy, and hosting history tracking. Use when the user says "host", "host this", "host file", "publish", "publish this", "share this file", "upload to R2", "make this public", "get a shareable link", "deploy this file", "put this online", or any variation of wanting to make a file publicly accessible via URL.

Jak działa

  1. Prerequisites
  2. Step 1 — Check prerequisites
  3. Step 2 — Identify the asset
  4. Step 3 — Generate the key
  5. Step 4 — Upload
  6. Step 5 — Report
  7. History
  8. Custom domains
Sekcje z nagłówków SKILL.md, w oryginale · 133 linii, 662 słów
Podgląd SKILL.md
---
name: host
description: >-
  Upload files to Cloudflare R2 and return a shareable public URL. Supports any
  file type (HTML, images, PDFs, etc.) with automatic slug generation, clipboard
  copy, and hosting history tracking. Use when the user says "host", "host this",
  "host file", "publish", "publish this", "share this file", "upload to R2",
  "make this public", "get a shareable link", "deploy this file", "put this online",
  or any variation of wanting to make a file publicly accessible via URL.
license: MIT
metadata:
  author: jcottam
  version: "1.2.0"
---

# Host

Upload any file to Cloudflare R2 and get back a shareable public URL.

`SCRIPTS` below refers to the `scripts/` directory next to this file.

## Prerequisites

- **Wrangler CLI** — the Cloudflare developer CLI used for all R2 operations
- **Cloudflare account** with an R2 bucket that has public access enabled (r2.dev subdomain or custom domain)
- **Wrangler authenticated** via one of:
  - `wrangler login` (interactive OAuth — run once, token persists in `~/.wrangler`)
  - `CLOUDFLARE_API_TOKEN` environment variable

## Step 1 — Check prerequisites

### Wrangler installation

Check if `wrangler` is available:

```bash
wrangler --version
```

If not installed, install it globally:

```bash
npm install -g wrangler
```

### Wrangler authentication

Verify auth status:

```bash
wrangler whoami
```

If not authenticated, the user must run `wrangler login` interactively (opens a browser for OAuth). This is a one-time step.

### Host configuration

Look for `~/.publish.json`. If it doesn't exist, run `$SCRIPTS/setup.sh` and walk the user through the prompts. The setup script creates the config file with:

```json
{
  "bucket": "my-bucket-name",
  "publicBaseUrl": "https://pub-xxx.r2.dev"
}
```

If the file exists, read it and parse the `bucket` and `publicBaseUrl` values. Both are required.

## Step 2 — Identify the asset

Determine what file to host from context:

1. If the user specified a file path, use that.
2. If the user said "host this" without a path, check for:
   - A file the user is currently viewing or recently created
   - A `.canvas.tsx` output or generated HTML file from the current session
3. Verify the file exists before proceeding. If ambiguous, ask the user to clarify.

## Step 3 — Generate the key

Decide the R2 object key (the path within the bucket):

- **Default**: derive a readable slug from the filename.
  - Strip extension, lowercase, replace spaces and special characters with hyphens
  - Append today's date: `my-report-2026-05-15`
  - Re-attach the original file extension
  - Example: `Sales Report Q1.html` becomes `sales-report-q1-2026-05-15.html`
- **User override**: if the user provided a custom name, use it instead (sanitized).
- **Collision check**: scan `~/.publish-history.json` for the key. If it exists, ask the user whether to overwrite or append a suffix (`-2`, `-3`, etc.).

## Step 4 — Upload

Run the host script:

```bash
$SCRIPTS/host.sh <file-path> [--key <custom-key>]
```

The script:
1. Reads `~/.publish.json` for bucket name and public URL base
2. Detects the content type from the file extension
3. Uploads via `wrangler r2 object put <bucket>/<key> --file <path> --content-type <type> --remote`
4. Constructs the public URL: `<publicBaseUrl>/<key>`
5. Copies the URL to the clipboard (`pbcopy` on macOS, `xclip`/`xsel` on Linux)
6. Appends an entry to `~/.publish-history.json`
7. Outputs JSON with `url`, `key`, `contentType`, `size`, and `publishedAt`

**Important:** The `--remote` flag is required. Without it, Wrangler uploads to a local R2 simulator instead of the actual Cloudflare R2 bucket.

If the script exits non-zero, report the error to the user. Common issues:
- **Wrangler not installed**: suggest `npm install -g wrangler`
- **Not authenticated**: suggest running `wrangler login`
- **Bucket not found**: confirm the bucket name in `~/.publish.json` and that public access is enabled
- **File not found**: re-check the file path

## Step 5 — Report

After a successful upload:

1. Print the public URL prominently.
2. Confirm the URL was copied to the clipboard.
3. Mention the entry was added to history.

Example output:

```
Hosted: https://pub-xxx.r2.dev/sales-report-q1-2026-05-15.html
Copied to clipboard.
```

## History

Use `$SCRIPTS/history.sh` to interact with the local hosting history at `~/.publish-history.json`.

| Command | Description |
|---------|-------------|
| `history.sh list` | Show the 10 most recent uploads |
| `history.sh list --all` | Show all uploads |
| `history.sh search <query>` | Filter entries by key or local path |
| `history.sh prune` | Remove entries whose R2 objects no longer exist |

When the user asks to see their hosting history, list recent uploads, or find a previously hosted file, use the appropriate history command.

## Custom domains

For setting up a custom domain instead of the default `r2.dev` URL, see [references/custom-domain.md](references/custom-domain.md).
Pliki w paczce (5)
  • SKILL.md 5 KB
  • references/custom-domain.md 2 KB
  • scripts/history.sh 4 KB
  • scripts/host.sh 5 KB
  • scripts/setup.sh 2 KB

Wersje

W bazie nie ma innych skilli o nazwie host.

Migawka bazy z 13.11.2026 · wersja paczki 7be6138eaf22 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100file-upload
    Wysyła plik, na przykład raport HTML albo zrzut ekranu, przez CLI fileslop i zwraca publiczny link do udostępnienia.
  • 100publish-to-mdpage
    Zamienia dowolny Markdown w stronę internetową do udostępnienia przez md.page i zwraca link.
  • 96upload-cdn
    Wysyła lokalny plik do magazynu obiektów zgodnego z S3, na przykład Cloudflare R2, i zwraca publiczny adres URL.
  • 100publish-to-filecoin
    Wysyła pliki lub foldery do Filecoin w testnecie Calibration przez CLI i zwraca linki do udostępnienia.
  • 100pagepin
    Publikuje stronę HTML, plik Markdown, obraz lub statyczny serwis wielostronicowy na hoście pagepin, zwraca link do udostępnienia i prowadzi pętlę komentarzy z poprawkami.
  • 100deploy
    Wdraża i publikuje pojedynczy plik HTML (prezentację, stronę, dokument) w hostingu FluidDocs skryptem deploy.sh, obsługuje logowanie w przeglądarce i otwiera żywy adres.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.