appgarden — Claude Code skill: what it does, how to install
Manages web application deployments on remote servers via SSH using the AppGarden CLI. Configures services, inspects logs, and exposes local ports through tunnels.
no license 509 installs updated 2026-09-04
npx skills add lukastk/appgarden --skill appgarden -a claude-codeWhat appgarden does
This skill teaches coding assistants how to control the appgarden command-line utility. The tool runs agentless over SSH. It provisions remote hosts, creates configurations for Caddy, Docker, or systemd, and tracks deployment records in /srv/appgarden. The assistant executes safe read-only queries like apps status and server ping automatically, but pauses to request permission before running destructive operations, modifying firewall rules, or stopping containers.
Multiple deployment roots can exist on a single machine under custom app_root locations. Because systemd units and Docker containers use a shared host prefix appgarden-<name>, application names must remain unique across the entire machine. Network port assignments are coordinated across all gardens through a central host registry at /var/lib/appgarden/ports.json to prevent port collisions.
What it helps with
- deploy web services to remote hosts via SSH
- generate and validate
appgarden.tomldeployment profiles - inspect remote application logs, health status, and metadata
- expose local development ports through public tunnels
Example prompts for the agent
- Generate an appgarden.toml setup for a containerized service on myserver
- Inspect runtime logs and deployment status for myapp
- Open an appgarden tunnel to expose local port 3000 through myserver
How to install appgarden
1Skills CLI (Vercel)
npx skills add lukastk/appgarden --skill appgarden -a claude-code2Manually: put the files in place
~/.claude/skills/appgarden/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/appgarden/
1Skills CLI (Vercel)
npx skills add lukastk/appgarden --skill appgarden -a codex2Manually: put the files in place
.agents/skills/appgarden/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lukastk/appgarden --skill appgarden -a cursor2Manually: put the files in place
.cursor/skills/appgarden/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lukastk/appgarden appgarden2Manually: put the files in place
.github/skills/appgarden/SKILL.md1Skills CLI (Vercel)
npx skills add lukastk/appgarden --skill appgarden -a gemini-cli2Platform CLI
gemini skills install https://github.com/lukastk/appgardenManually: put the files in place
.devin/skills/appgarden/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lukastk/appgarden --skill appgarden -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about appgarden
How to install appgarden in Claude Code?
Run npx skills add lukastk/appgarden --skill appgarden -a claude-code. The skill file will be stored at ~/.claude/skills/appgarden/SKILL.md.
What does the appgarden skill do?
It guides the agent on operating the AppGarden CLI for server initialization, container lifecycle management, and log review without needing background daemons on the host.
What are the server prerequisites before deploying an app?
The host needs active SSH access and configured DNS records pointing to its IP address. Initial host setup is handled by running appgarden server init <server-name>.