Headless

Set up a headless Mac (Apple silicon), Linux or Windows machine over SSH, step by step, from "an admin account with a password and SSH on" to a configured machine with key-only SSH, automatic sign-in, never-sleep settings and optional Tailscale - on a Mac with Determinate Nix and nix-darwin, on Linux with a NixOS module (installing NixOS with nixos-anywhere if the user wants) or a distro-neutral script for Debian, Ubuntu and Fedora, on Windows 11 or Windows Server with a rerunnable PowerShell configuration - then restart it and confirm it comes back. Use when the user wants to set up, configur

208 stars 13 forksDevOps & Cloud

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add kunchenguid/headless --skill headless
Manual install
git clone --depth 1 https://github.com/kunchenguid/headless.git /tmp/headless
mkdir -p ~/.claude/skills
cp -r /tmp/headless/skills/headless ~/.claude/skills/headless

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# headless

Guide the user through setting up one headless machine over SSH. Go one
step at a time: say what the step does, run it, show its result, and only
then move on. Every step is safe to run again.

This version covers **Macs** (steps 1 to 7), **Linux machines** ("Linux
machines" below) and **Windows machines** ("Windows machines" below); step 2
and the rules are shared.

All scripts live in this skill's `scripts/` folder; call them by path.
`$SKILL` below means this skill's folder.

## Rules that never bend

- **Never see the password.** Do not ask the user to type it to you, paste
  it, or put it in a file you read. Never run a command that prints a
  secret (`op read`, `bw get`, `cat` on the env file, `secret-run.sh ... --
  cat`, `echo $...`). You only handle the store *entry name*, such as
  `av:HEADLESS_MAC_PASSWORD`. The scripts read the secret themselves and
  pipe it to `sudo -S` or SSH; it never reaches a command line or a log.
- **Never weaken sudo.** Do not add a passwordless sudo rule. Every later
  admin step reads the password from the store again.
- **Key before key-only.** Password sign-in turns off only after
  `connect.sh` has proved the user's key works.
- **Ask before anything the user did not choose**, and stop and ask when a
  step fails in a way its message does not explain.

## Step 1: Admin access at the Mac (the user does this)

Ask the user to confirm, at the Mac itself (screen and keyboard, or screen
sharing), that:
Read the full skill on GitHub

Details

Skill name
headless
Path
skills/headless/SKILL.md
License
MIT
Repo updated
13 November 2026

FAQ

What does the Headless skill do?

Set up a headless Mac (Apple silicon), Linux or Windows machine over SSH, step by step, from "an admin account with a password and SSH on" to a configured machine with key-only SSH, automatic sign-in, never-sleep settings and optional Tailscale - on a Mac with Determinate Nix and nix-darwin, on Linux with a NixOS module (installing NixOS with nixos-anywhere if the user wants) or a distro-neutral script for Debian, Ubuntu and Fedora, on Windows 11 or Windows Server with a rerunnable PowerShell configuration - then restart it and confirm it comes back. Use when the user wants to set up, configur

How do I install the Headless skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add kunchenguid/headless --skill headless. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Headless popular?

It lives in kunchenguid/headless, which has 208 GitHub stars and 13 forks.

Related skills

CI CD Pipeline

492

cosmicstack-labs/mercury-agent-skills

Design and implement production-grade CI/CD pipelines with GitHub Actions, layered testing strategies, secure deployment patterns, and environment management.

DevOps & Cloud68

Azure Functions

514

Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

Expert patterns for Azure Functions development including isolated worker model, Durable Functions orchestration, cold start optimization, and production patterns. Covers .NET, Python, and Node.js programming models. Use when: azure function, azure functions, durable functions, azure serverless, function app.

DevOps & Cloud146

Docker Patterns

492

cosmicstack-labs/mercury-agent-skills

Master Dockerfile optimization, multi-stage builds, docker-compose patterns, security hardening, and image size reduction techniques for production-grade containerization.

DevOps & Cloud68

AWS Serverless

514

Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

Specialized skill for building production-ready serverless applications on AWS. Covers Lambda functions, API Gateway, DynamoDB, SQS/SNS event-driven patterns, SAM/CDK deployment, and cold start optimization.

DevOps & Cloud146

Kubernetes Patterns

492

cosmicstack-labs/mercury-agent-skills

Pods, deployments, services, ingress, RBAC, autoscaling, and production cluster best practices

DevOps & Cloud68

Book Release Readiness

559

KunoLu/640-skills

Reviews production readiness for services, APIs, jobs, queues, integrations, and deployment-sensitive changes. In strict tasks, mandatory after all applicable testing-tool gates and project validation, and before completion or release, when production-path runtime or deployment behavior changes; in default/lite tasks, use on demand when those risks or explicit delivery requirements are present.

DevOps & Cloud13

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.