#39 - feat: add tailscale bundle — first bundle in bundles/ directory - magnus/agent-skills

jasper commented

2026-05-28 00:14:41 -04:00

Contributor

What does this PR do?

Adds the first bundle to the agent-skills repo — a new bundles/ directory for organizing related skills under a shared umbrella. The tailscale bundle is the inaugural entry.

The tailscale bundle provides 7 sub-skills for managing a self-hosted Tailscale/Headscale VPN ecosystem:

headscale-deploy — Deploy and configure a Headscale control server (binary or Docker)
tailnet-policy — Author and validate huJSON ACL/Grant policy files
tailscale-client — Install, connect, and diagnose Tailscale clients pointing at Headscale
headscale-node-lifecycle — Auth keys, node registration/approval/tagging/decommissioning
headscale-routing — Subnet routers and exit nodes
headscale-derp — DERP relay deployment and latency testing
headscale-backup — SQLite backup/restore and full migration

Includes 23 scripts (all with --json/--dry-run), 8 reference documents, and 6 deployment templates. All scripts pass syntax validation and --help smoke tests (54/54).

Bundle Structure

bundles/tailscale/
├── SKILL.md                  # Umbrella orchestrator (auto-loads by trigger context)
├── AGENTS.md                 # Auto-load protocol
├── references/ (8 files)     # CLI refs, REST API, policy syntax, etc.
├── templates/ (6 files)      # Docker Compose, config, policies, DERP map
├── scripts/ (5 files)        # Shared utilities
└── skills/ (7 sub-skills)
    ├── headscale-deploy/     # 3 scripts
    ├── tailnet-policy/       # 3 scripts (2 Python + 1 Bash)
    ├── tailscale-client/     # 4 scripts (3 Bash + 1 Python)
    ├── headscale-node-lifecycle/  # 4 scripts
    ├── headscale-routing/    # 3 scripts
    ├── headscale-derp/       # 3 scripts (2 Bash + 1 Python)
    └── headscale-backup/     # 3 scripts

Type of Change

New skill or bundle

Checklist

SKILL.md has valid YAML frontmatter (name, description)
name field matches parent directory name
SKILL.md is under 5000 tokens (largest is tailnet-policy at ~2171 tokens)
Detailed reference material in references/ for progressive disclosure
All scripts pass syntax validation (bash -n / py_compile)
All scripts have --help, --json, and --dry-run where applicable
No internal paths, hostnames, or secrets in published files
No self-referencing loopback instructions
README updated with bundle entry

Filed by Jasper (AI agent on behalf of Magnus Hedemark)

## What does this PR do? Adds the first **bundle** to the agent-skills repo — a new `bundles/` directory for organizing related skills under a shared umbrella. The tailscale bundle is the inaugural entry. The tailscale bundle provides 7 sub-skills for managing a self-hosted Tailscale/Headscale VPN ecosystem: - **headscale-deploy** — Deploy and configure a Headscale control server (binary or Docker) - **tailnet-policy** — Author and validate huJSON ACL/Grant policy files - **tailscale-client** — Install, connect, and diagnose Tailscale clients pointing at Headscale - **headscale-node-lifecycle** — Auth keys, node registration/approval/tagging/decommissioning - **headscale-routing** — Subnet routers and exit nodes - **headscale-derp** — DERP relay deployment and latency testing - **headscale-backup** — SQLite backup/restore and full migration Includes 23 scripts (all with --json/--dry-run), 8 reference documents, and 6 deployment templates. All scripts pass syntax validation and --help smoke tests (54/54). ## Bundle Structure ``` bundles/tailscale/ ├── SKILL.md # Umbrella orchestrator (auto-loads by trigger context) ├── AGENTS.md # Auto-load protocol ├── references/ (8 files) # CLI refs, REST API, policy syntax, etc. ├── templates/ (6 files) # Docker Compose, config, policies, DERP map ├── scripts/ (5 files) # Shared utilities └── skills/ (7 sub-skills) ├── headscale-deploy/ # 3 scripts ├── tailnet-policy/ # 3 scripts (2 Python + 1 Bash) ├── tailscale-client/ # 4 scripts (3 Bash + 1 Python) ├── headscale-node-lifecycle/ # 4 scripts ├── headscale-routing/ # 3 scripts ├── headscale-derp/ # 3 scripts (2 Bash + 1 Python) └── headscale-backup/ # 3 scripts ``` ## Type of Change - [x] New skill or bundle ## Checklist - [x] SKILL.md has valid YAML frontmatter (name, description) - [x] name field matches parent directory name - [x] SKILL.md is under 5000 tokens (largest is tailnet-policy at ~2171 tokens) - [x] Detailed reference material in references/ for progressive disclosure - [x] All scripts pass syntax validation (bash -n / py_compile) - [x] All scripts have --help, --json, and --dry-run where applicable - [x] No internal paths, hostnames, or secrets in published files - [x] No self-referencing loopback instructions - [x] README updated with bundle entry --- Filed by Jasper (AI agent on behalf of Magnus Hedemark)

jasper added 1 commit

2026-05-28 00:14:41 -04:00

feat: add tailscale bundle — self-hosted Tailscale/Headscale skill collection 96caf3ae06

Adds the first bundle to the agent-skills repo under bundles/:
a collection of 7 sub-skills for managing the self-hosted
Tailscale/Headscale VPN ecosystem.

Includes 23 scripts (bash + python), 8 reference documents,
6 deployment templates, and a context-aware umbrella SKILL.md
that auto-loads sub-skills by trigger keywords.

magnus merged commit 0589de3718 into main

2026-05-28 00:15:46 -04:00

magnus referenced this pull request from a commit

2026-05-28 00:15:48 -04:00

Merge pull request 'feat: add tailscale bundle — first bundle in bundles/ directory' (#39) from feat/tailscale-bundle into main

Rows
Columns

feat: add tailscale bundle — first bundle in bundles/ directory #39

What does this PR do?

Bundle Structure

Type of Change

Checklist