Skip to content

Unique-Divine/jiyuu / ai-skills/tailscale-serve

tailscale-serve

Verified

Troubleshoot, document, and operate Tailscale Serve for local development previews, HTTPS `.ts.net` URLs, MagicDNS, admin-console HTTPS certificate setup, WSL or localhost proxy targets, phone testing over a tailnet, and curl/OpenSSL diagnosis of Serve TLS failures. Use when a user says Tailscale Serve, `tailscale serve`, `.ts.net`, MagicDNS, HTTPS certs, SSL protocol error, TLS alert, Funnel versus Serve, localhost preview, Next.js preview over Tailscale, or sharing a dev server with a phone or another tailnet device.

FileKindSize
SKILL.mdskill md8.3 KB
test-prompts.mdmarkdown1.7 KB

test-prompts.md

View on GitHub
# Test prompts for `tailscale-serve`

Use these prompts to review whether the skill gives practical, evidence-driven
Tailscale Serve help.

## Test 1: HTTPS fails but localhost works

Prompt:

```text
I'm running Next on http://127.0.0.1:3000 and `tailscale serve status` shows
https://devbox.example-tailnet.ts.net -> http://127.0.0.1:3000, but Chrome says
ERR_SSL_PROTOCOL_ERROR for the `.ts.net` URL. `curl http://127.0.0.1:3000`
returns 200. What should I check?
```

Expected result:

- Separates local HTTP target from Serve HTTPS frontend.
- Suggests command `tailscale cert` and admin-console HTTPS certificate checks.
- Uses command `curl -vk` or `openssl s_client` to verify the TLS failure.
- Does not blame Next.js before checking Tailscale cert support.

## Test 2: Phone cannot open preview

Prompt:

```text
I want to open my local Vite app from my iPhone through Tailscale Serve. My app
is on port 5173 on my WSL machine. The phone is on Tailscale but not on my home
wifi. What exact flow should I use?
```

Expected result:

- Explains that the phone opens the HTTPS `.ts.net` URL, not `localhost`.
- Checks that the phone and serving machine are in the same tailnet.
- Handles WSL/Windows localhost ambiguity.
- Provides `curl`, `tailscale serve`, and `tailscale serve status` commands.

## Test 3: App loads but assets break

Prompt:

```text
My Tailscale Serve URL opens the page, but the JS chunks and websocket calls are
still going to localhost:3000 and failing on my other laptop. How do I debug
this?
```

Expected result:

- Identifies this as an app/browser URL problem after Serve is working.
- Suggests checking absolute URLs, WebSocket origins, and dev-origin settings.
- Does not focus on certificate setup once HTTPS page load is confirmed.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall