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
Install
npx skills add kunchenguid/headless --skill headlessgit clone --depth 1 https://github.com/kunchenguid/headless.git /tmp/headless
mkdir -p ~/.claude/skills
cp -r /tmp/headless/skills/headless ~/.claude/skills/headlessPersonal 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:Details
- Skill name
headless- Repository
- kunchenguid/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
492cosmicstack-labs/mercury-agent-skills
Design and implement production-grade CI/CD pipelines with GitHub Actions, layered testing strategies, secure deployment patterns, and environment management.
Azure Functions
514Dokhacgiakhoa/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.
Docker Patterns
492cosmicstack-labs/mercury-agent-skills
Master Dockerfile optimization, multi-stage builds, docker-compose patterns, security hardening, and image size reduction techniques for production-grade containerization.
AWS Serverless
514Dokhacgiakhoa/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.
Kubernetes Patterns
492cosmicstack-labs/mercury-agent-skills
Pods, deployments, services, ingress, RBAC, autoscaling, and production cluster best practices
Book Release Readiness
559KunoLu/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.
Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.