Menu
Detects first-run state and prompts user to configure Dockhand. Active when config is missing or incomplete.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Policy enforcement for safe infrastructure operations. Automatically active to prevent destructive actions, enforce PR workflows, and ensure backup-before-modify patterns.
Day-to-day application lifecycle management. Use when user wants to manage apps, check app status, list applications, manage domains, start/stop/restart apps, or says "apps", "applications", "services", "my apps".
Guide deployment workflows for applications. Use when user wants to deploy an app, deploy a template, redeploy a service, browse templates, or says "deploy", "launch", "spin up", "install app".
Generate infrastructure status reports and health checks. Use when user asks for platform status, health check, system overview, service status, or says "what's running", "check health", "show status".
Infrastructure-as-code operations with Terraform. Use when user wants to run terraform, manage infrastructure, bootstrap new hosts, change infrastructure, or says "terraform", "infrastructure", "IaC", "provision".
Systematic debugging for infrastructure issues. Use when user reports errors, app not working, 502/504 errors, certificate problems, DNS issues, or says "debug", "not working", "help", "broken", "error".
| name | dh-first-run |
| type | always-on |
| description | Detects first-run state and prompts user to configure Dockhand. Active when config is missing or incomplete. |
Automatically detect when Dockhand is unconfigured and guide users to setup.
When ANY Dockhand command or skill is invoked, first check configuration state:
# Check if config exists and read mode
ls ~/.config/dockhand/config.json 2>/dev/null
If config file does not exist, respond with:
Dockhand is not yet configured. Let me help you set it up.
Would you like to run the setup wizard now? This will:
1. Choose your setup mode (Client Portal or Admin)
2. Configure credentials and connectivity
3. Generate the necessary configuration files
Run `/dh-setup` to begin, or I can start the wizard for you now.
Then use AskUserQuestion:
question: "Would you like to run the Dockhand setup wizard?"
options:
- "Yes, start setup now"
- "No, I'll configure manually"
If user chooses "Yes", invoke the /dh-setup command flow.
If user chooses "No", provide manual setup instructions:
To configure Dockhand manually:
For Client Portal users:
1. Get your API token from your Client Portal settings
2. Create ~/.mcp.json with the MCP configuration shown in the portal
3. Create ~/.config/dockhand/config.json with: {"mode": "client"}
For Admin users:
1. Create config directory: mkdir -p ~/.config/dockhand
2. Create config file at ~/.config/dockhand/config.json
(See dockhand.config.example.json in the plugin directory)
3. Create .mcp.json with MCP server config
4. Set up credentials via 1Password or .env.dockhand file
Run /dh-setup anytime to use the interactive wizard.
Also check for incomplete configuration:
Missing required fields - If config exists but is missing critical fields:
mode (must be "client" or "admin")platform_domain, hosts, dokploy.url, cloudflare.zone_idmcp_server_urlRespond with:
Your Dockhand configuration appears incomplete. Missing: <list fields>
Would you like to run /dh-setup to complete the configuration?
Do NOT show first-run prompts when:
/dh-setupThis skill runs BEFORE other Dockhand skills. If config is missing: