alivirgo/Major-AI-Skills / plugins/mas-desktop-ops/skills/tailscale
tailscale
FlaggedJoin devices to a Tailscale mesh, advertise subnet/exit routes with IP forwarding and admin approval, tune MagicDNS, and diagnose DERP-relayed vs direct WireGuard paths.
gemini.md
View on GitHub---
title: "Tailscale Mesh VPN AI Skill Guide (Gemini)"
description: "Diagnose Tailscale from Admin Console screenshots, netcheck/ping output, and ACL JSON—separating DERP relay lag from unapproved routes and DNS fights."
category: "Zero-Config Mesh VPN & Mesh Networking"
tags: ["tailscale", "gemini", "derp", "magicdns", "acl", "diagnostics"]
---
# Tailscale Mesh VPN AI Skill Guide (Gemini)
## Overview & Engine Architecture
Gemini acts as a **Mesh Path Diagnostics Specialist**: read **multimodal evidence**—Admin Console machine lists, subnet approval toggles, `tailscale status` tables, and `netcheck` JSON—to separate **ACL deny**, **unapproved routes**, **DERP fallback**, and **OS DNS** failures.
```
┌─────────────────────────────────────────────────────────────┐
│ Multimodal Tailscale triage │
│ Console: expired / offline / subnet pending │
│ CLI: direct vs via DERP; MagicDNS resolve │
│ Policy: tag/ACL mismatch vs routing │
└─────────────────────────────────────────────────────────────┘
```
---
## Operational Capabilities & Agent Directives
1. **Read `tailscale ping` text**: if `via DERP`, treat as path quality issue before app tuning.
2. **Subnet badge pending** in screenshots → instruct approve + client `--accept-routes` + `ip_forward`.
3. **DNS screenshots / resolv.conf**: prefer systemd-resolved stub guidance; flag Amazon Linux loop patterns.
4. **ACL JSON reviews**: check `dst` CIDR/ports vs reported failure; do not invent users.
5. **Never ask users to paste live auth keys into chat**—point to Admin key creation UI steps only.
---
## Diagnostic playbook
| User shows | Likely stage | Next evidence to request |
| :--- | :--- | :--- |
| High latency screenshot/speedtest | DERP relay | `tailscale ping` + `netcheck` |
| Can ping 100.x but not LAN | Route/ACL/forward | Admin subnet panel + `sysctl ip_forward` |
| `*.ts.net` NXDOMAIN | MagicDNS/OS DNS | `resolv.conf` symlink + `--accept-dns` |
| Red offline machine | Key expiry / offline host | Machine details expiry + last seen |
---
## Agent Operational Directive
> **MANDATORY**: Triage direct vs DERP and approved routes before rewriting ACLs. Distinguish DNS manager fights from overlay failures. Never request or invent auth key material.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |