uncloud — Claude Code Skill

A Claude Code skill for managing Uncloud homelab clusters with the uc CLI.

What This Skill Covers

• CLI reference — machines, services, images, volumes, Caddy, DNS, contexts
• Port publishing — HTTP/HTTPS via Caddy, TCP/UDP host-bound, with examples
• Compose extensions — x-ports, x-caddy (template functions), x-machines
• External device routing — proxy non-cluster devices (BMC, NAS, router UIs) via Caddy with --caddyfile
• Internal service DNS — how services discover each other inside the WireGuard mesh
• Image tag templates — {{gitsha}}, {{gitdate}} in compose.yaml
• Common mistakes — Caddyfile editing pitfalls, self-signed cert handling, volume lifecycle

Installation

Claude Code

mkdir -p ~/.claude/skills/uncloud
curl -fsSL https://raw.githubusercontent.com/suranyami/uncloud-skill/main/SKILL.md \
  -o ~/.claude/skills/uncloud/SKILL.md

Or clone the repo:

git clone git@github.com:suranyami/uncloud-skill.git ~/.claude/skills/uncloud

Cross-client (.agents/skills/)

mkdir -p ~/.agents/skills/uncloud
curl -fsSL https://raw.githubusercontent.com/suranyami/uncloud-skill/main/SKILL.md \
  -o ~/.agents/skills/uncloud/SKILL.md

Usage

Once installed, Claude Code will automatically load the skill when you ask about Uncloud operations. You can also invoke it explicitly:

/uncloud

Example Prompts

• "Deploy my web app to the Uncloud cluster on port 443"
• "Add a Caddy reverse proxy for my TuringPi BMC at 192.168.1.75"
• "How do I scale my API service to 3 replicas?"
• "What's the internal DNS name for my postgres service?"

Resources

• Uncloud documentation
• Agent Skills specification
• everything-claude-code plugin

License

MIT