Uncloud

This teaches Claude to work with Uncloud, a decentralized self-hosting platform that runs Docker services across peer machines connected by WireGuard mesh networking. It's for when you're deploying apps with the `uc` CLI, configuring Caddy ingress through compose file extensions like `x-ports` and `x-caddy`, or managing cluster state across machines without a central control plane. The reference is thorough on the CLI surface and Compose syntax, including the clever trick of using a pause container with `--caddyfile` to proxy traffic to non-cluster devices like a BMC or NAS. Useful if you're running homelab or small-scale infrastructure and want something simpler than Kubernetes but more capable than docker-compose on a single box.

skills.sh installs: 5.3K
GitHub stars: 300.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/ecc --skill uncloud --agent claude-code

Installs into .claude/skills of the current project.

Files

Uncloud Cluster Management

Reference for the uc CLI — a decentralised self-hosting platform using Docker containers, WireGuard mesh networking, and Caddy reverse proxy.

When to Activate

Use this skill when working with Uncloud clusters, especially when:

Bootstrapping or joining machines with uc machine
Deploying services from Compose files with uc deploy
Publishing HTTP, HTTPS, TCP, or UDP ports through Uncloud
Configuring Caddy ingress with x-caddy, x-ports, or --caddyfile
Routing external LAN devices through the cluster proxy
Inspecting logs, service state, volumes, DNS, or machine placement

How It Works

Uncloud runs Docker services across peer machines connected by a WireGuard mesh. Each machine is an equal cluster member; services communicate on the overlay network and Caddy runs globally to terminate public HTTP/HTTPS traffic. Compose files can use Uncloud extensions for ingress, placement, and generated Caddy configuration, while the uc CLI handles image distribution, scheduling, scaling, logs, and cluster state.