✦Agent Skill # Teach Your Agent to Deploy Your Code Download the DeployHQ Skill and your agent learns to install the CLI, deploy, roll back, and manage your servers — all from a chat. Works with Claude (claude.ai and Claude Desktop) and OpenAI Codex. Takes 30 seconds to set up. [Download the skill](/skills/deployhq-claude.skill)[How agents connect →](/agents) Free — no account to install Claude & Codex Set up in 30 seconds Last updated on 22nd June 2026 Agent \> "Deploy my app to production" Using DeployHQ skill... ✓ dhq deploy -p my-app -s production ✓ Building (npm run build) ✓ Transferring 42 files Deployed to production in 38s A skill is a small bundle of instructions your agent loads on demand. The DeployHQ Skill teaches your agent exactly how to drive the`dhq` command-line tool — how to authenticate, create deployments, watch progress, read logs, and roll back. Add it once and your agent can deploy for you in plain language, no copy-pasting commands. ## Add It to Your Agent in 3 Steps Pick your agent — Claude installs the skill via upload, Codex reads an AGENTS.md file. ClaudeCodex 1 ### Download Grab the skill bundle — a single`.skill`file. [Download skill](/skills/deployhq-claude.skill) 2 ### Upload to Claude In Claude, open **Settings → Capabilities → Skills** and choose **Upload skill.** Select the`.skill`file you downloaded, then enable it. 3 ### Deploy Ask Claude to deploy. It installs and authenticates the CLI if needed, then runs the deployment for you. \>`Deploy my-app to production` 1 ### Download Grab the Codex build — a single`AGENTS.md`file. [Download AGENTS.md](/skills/deployhq-codex.md) 2 ### Save to your repo Save it as`AGENTS.md`in your repo root — or`~/.codex/AGENTS.md`to make it available globally. Prefer a one-liner? Run`dhq setup codex`in your repo instead. 3 ### Deploy Codex reads the file automatically. Just ask it to deploy — it installs and authenticates the CLI if needed, then runs the deployment for you. \>`Deploy my-app to production` ## What the Skill Knows Built from the same reference the DeployHQ CLI ships to coding agents. ### Install & Authenticate Walks your agent through installing the dhq binary and logging in — or using environment variables in CI — before it touches your infrastructure. ### Deploy & Roll Back Create deployments, watch them complete, read step logs when something breaks, and roll back to a previous release. ### Projects & Servers Create and configure projects, connect repositories, and manage SSH, FTP, and S3 deployment targets. ### Config & Env Vars Manage environment variables, config files, build commands, exclusions, and deployment checks. ### JSON for Agents Every command returns structured JSON with suggested next steps, so your agent never has to guess an endpoint. ### Full API Escape Hatch When a command doesn't exist, the skill knows how to call any of the 144+ DeployHQ API endpoints directly. ## Using Claude Code, Cursor, or Windsurf Instead? The tabs above cover Claude and Codex. If you work in another terminal-based coding agent, the CLI sets you up directly. Run the setup command inside your repo and the DeployHQ CLI installs the right integration for your agent automatically — a skill for Claude Code, a project rule for Cursor, or a Windsurf integration. $`dhq setup claude` $`dhq setup cursor # or: windsurf` [See all agent integrations →](/agents) ## Frequently Asked Questions ### What is the DeployHQ Agent Skill? It's a downloadable bundle of instructions your AI agent loads when it's relevant. It teaches the agent how to use the dhq command-line tool to deploy code, manage servers, and roll back releases. We ship two builds: a .skill bundle for Claude and an AGENTS.md file for OpenAI Codex. ### Do I need a paid plan? Claude Skills are available on claude.ai and the Claude Desktop app, and Codex reads the AGENTS.md file from your repo. You don't need a DeployHQ account just to install the skill, but you'll need one (free plans available) to actually deploy. ### How do I install it? For Claude: download the .skill file, then go to Settings → Capabilities → Skills and upload it. For Codex: download the AGENTS.md file and save it in your repo root (or ~/.codex/AGENTS.md for global), or run `dhq setup codex` in your repo — Codex reads it automatically. ### Does this work with Claude Code, Cursor, or Windsurf? Yes. Those terminal-based agents have a better path: run `dhq setup claude` (or cursor, windsurf) inside your project and the skill is installed directly into the agent's config. The downloadable skill here is aimed at chatting with Claude on claude.ai or Desktop, or running OpenAI Codex. ### Is it safe? The skill only contains instructions and reference docs — no secrets. It tells your agent how to use the dhq CLI, which uses your own DeployHQ credentials stored locally on your machine or in your CI environment. ### Is it free? Yes. The skill and the DeployHQ CLI are free. You need a DeployHQ account to deploy — free plans are available. ## Let your agent handle the deploy Download the skill, add it to your agent, and ship from a conversation. [Download the skill](/skills/deployhq-claude.skill)[Get started free](/signup?cta=Get+started+free) Free to install • Works with Claude & Codex ## Explore More Features Discover all the tools that make DeployHQ the easiest way to deploy your code. [ ### Zero Downtime Deployments →](/features/zero-downtime-deployments)[ ### One-Click Rollback →](/features/one-click-rollback)[ ### Turbo Deployments →](/features/turbo-deployments)[ ### Build Pipelines →](/features/build-pipelines)[ ### Build Cache →](/features/build-cache)[ ### Scheduled Deployments →](/features/scheduled-deployments)[ ### Deployment Availability →](/features/deployment-availability)[ ### Docker Builds →](/features/docker-builds)[ ### Deployment Checks →](/features/deployment-checks)[ ### Deployment Targets →](/features/deployment-targets)[ ### Automatic Deployment →](/features/automatic-deployments)[ ### Deployment Templates →](/features/deployment-templates)[ ### Deploy Behind Firewalls →](/features/deploy-behind-firewalls)[ ### SSH Deployment →](/features/ssh-deployment)[ ### Deployment Zones →](/features/deployment-zones)[ ### Team & Permissions →](/features/team-permissions)[ ### Single Sign-On →](/features/sso)[ ### Custom Actions →](/features/custom-actions)[ ### Server Management →](/features/server-management)[ ### CLI & Agents →](/agents)[ ### Powerful Integrations →](/features/integrations) ## Get started today for just $9/month That's unlimited deployments and 3 projects. [Start your free 10 day trial](/signup?cta=Start+your+free+10+day+trial)