Skip to content

alivirgo/Major-AI-Skills / plugins/mas-desktop-ops/skills/tailscale

tailscale

Flagged

Join 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.

FileKindSize
SKILL.mdskill md9.5 KB
gemini.mdmarkdown2.6 KB
gpt.mdmarkdown3.4 KB
---
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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall