# Agent skill for gddy (https://developer.godaddy.com/en/docs/api-users/cli/agent-skill)

---
title: Agent skill for gddy
description: >-
  Install the gddy agent skill so Claude Code or another AI coding agent can
  drive the GoDaddy CLI for you.
keywords: >-
  npx skills add godaddy/cli, claude plugin marketplace add, Claude Code Cursor
  Codex Windsurf opencode, gddy --dry-run, AI coding agent CLI, skills
  installer, gddy auth status check
agentNotes:
  permissions:
    - Any account
  scopes:
    - >-
      Depends on invoked command — the skill drives the gddy CLI, which inherits
      REST endpoint scopes
  rateLimit: >-
    N/A (installation only) — see /docs/api-users/rate-limits for the CLI's
    underlying call limits.
  idempotent: true
  destructive: false
  failureRecovery: >-
    Installation is safe to repeat. Re-run the install command to update or
    reinstall. Removing the skill does not affect the gddy CLI itself or its
    stored credentials.
related:
  guides:
    - title: Set up the CLI
      href: /docs/api-users/cli/set-up
    - title: CLI reference
      href: /docs/api-users/cli/reference
    - title: GoDaddy MCP server
      href: /docs/api-users/mcp
    - title: Authenticate
      href: /docs/api-users/auth
  concepts:
    - title: About the GoDaddy CLI
      href: /docs/api-users/cli
pageId: 178dcc46-c15f-4c90-8f01-602966769cba
---

## Overview

The `gddy` agent skill helps an AI coding agent install and use the [`gddy` CLI](https://developer.godaddy.com/docs/api-users/cli/set-up) on your behalf. Installing the skill is a one-time setup. After it's in place, describe what you want in plain language — find a domain, check pricing, register it, or update DNS records — and your agent runs the actual `gddy` commands using your own authenticated session.

After you install the skill, you can ask your agent things like:

* "Set up `gddy` for me." (installs the CLI; you're prompted to log in automatically the first time a command needs it)
* "Find available domains for a coffee subscription startup."
* "Is `example.com` available, and what would it cost to register?"
* "Add a CNAME record for `www` on `example.com` pointing to `example.github.io`."
* "List the DNS records on `example.com`."

Your agent will run the equivalent `gddy` commands, parse the JSON output, and summarize the result. It also knows how to use the CLI's self-documentation to stay current as `gddy` evolves (`gddy --help`, `gddy search <keywords>`, `gddy tree`, and `gddy guide`).

## Safety notes

The skill can purchase domains and modify DNS records if you ask it to. These guardrails apply when it does:

* Domain purchase is real money and not reversible. The skill walks through the quote-then-purchase flow and confirms with you before finalizing a purchase.
* `gddy dns set` and `gddy dns delete` are destructive — they replace or remove every matching record. The skill runs these with `--dry-run` first and shows you the change before applying it.
* The skill acts with whatever credentials and environment your `gddy` CLI is currently authenticated against. Check with `gddy auth status` if you're unsure which account or environment your agent is operating on.

This skill is not the same as the [GoDaddy MCP server](https://developer.godaddy.com/docs/api-users/mcp). The MCP server is a hosted, read-only service anyone can connect to for domain search and availability. The agent skill helps your coding agent install and run `gddy` itself, so it can do everything the CLI can do (including domain purchase and DNS management) using your own credentials. Go to [About the GoDaddy CLI](https://developer.godaddy.com/docs/api-users/cli#cli-agent-skill-mcp-server-and-rest-api) for a comparison of the CLI, the skill, and the MCP server.

## Install the skill

The skill is compatible with [skills](https://github.com/vercel-labs/skills), a package-manager-style installer for agent skills. It supports Claude Code, Cursor, Codex, Windsurf, opencode, and many other compatible AI coding agents. The following procedure installs the `gddy` agent skill.

**Claude Code**

* In Claude Code, run the following commands:
  ```bash
  claude plugin marketplace add godaddy/cli
  claude plugin install gddy@godaddy
  ```

**Any other AI coding agent**

* In your agent's terminal, run the following command:

  ```bash
  npx skills add godaddy/cli --skill gddy --agent $AGENT_NAME
  ```

Swap `$AGENT_NAME` for whichever agent you use (`claude-code`, `cursor`, `codex`, `windsurf`, `opencode`, and others). Run `npx skills add --help` for the full list of supported agents.