Skip to content

Add Claude Code plugin marketplace and agent skill for the gddy CLI#104

Merged
jpage-godaddy merged 12 commits into
godaddy:mainfrom
dkoopman-godaddy:add-claude-plugin-and-skills-support
Jul 15, 2026
Merged

Add Claude Code plugin marketplace and agent skill for the gddy CLI#104
jpage-godaddy merged 12 commits into
godaddy:mainfrom
dkoopman-godaddy:add-claude-plugin-and-skills-support

Conversation

@dkoopman-godaddy

@dkoopman-godaddy dkoopman-godaddy commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a Claude Code plugin marketplace (.claude-plugin/marketplace.json) containing a skill for installing and using the gddy CLI.

Test plan

  • claude plugin validate . and claude plugin validate ./plugins/gddy both pass with no warnings
  • Installed via claude plugin marketplace add + claude plugin install gddy@godaddy from the fork/branch — plugin and skill discoverable and installable
  • Installed via npx skills add <tree-url> --skill gddy --agent claude-code from the fork/branch
  • Asked the installed agent to check domain availability and add a DNS record — got the correct workflow reflecting SKILL.md guidance

dkoopman-godaddy and others added 2 commits July 14, 2026 14:10
…CLIs

Adds two independent skills (godaddy-cli, gddy) bundled into one plugin so
AI coding agents can drive both the stable npm-installed godaddy CLI and
the beta GitHub-Releases-installed gddy CLI without guessing at flags or
output formats. Each skill cross-references the other, and both ship a
README covering install via the Claude Code plugin marketplace or via
`npx skills` for other agents. Root README now points AI-driven users at
the skills as an installation option.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
CONTRIBUTING.md's Markdown Documentation section prohibits inline code
in headings and in link text; the new skill READMEs and the root README
edit had both.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Comment thread .agents/skills/godaddy-cli/SKILL.md Outdated
Comment thread .agents/skills/gddy/reference/api.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/godaddy-cli/README.md Outdated
Comment thread .agents/skills/gddy/reference/api.md Outdated
Comment thread .agents/skills/gddy/reference/api.md
dkoopman-godaddy and others added 2 commits July 14, 2026 15:46
…w, point to public OpenAPI specs

- Fix SKILL.md alignment nit (dkoopman-godaddy suggestion)
- Remove the llms.mdx-mirror section from gddy/SKILL.md: gddy --help is
  self-documenting, and the existing Setup section already covers install,
  so there's no docs-fetch needed for CLI usage (jpage-godaddy feedback).
  Move Setup earlier in the file per the same discussion.
- Trim the domain purchase section to point at `gddy domain quote/purchase
  --help` instead of hardcoding flag examples, keeping only the "why two
  calls, not one" framing that --help won't state on its own.
- Replace api.md's per-endpoint curl examples with pointers to GoDaddy's
  public OpenAPI specs (domains-v1.json, domains-v3.json), which cover
  every endpoint this file previously hardcoded and won't need updating
  as the API grows. Also add a pointer back to SKILL.md's Setup section
  for installing gddy itself.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…port' into add-claude-plugin-and-skills-support
Comment thread .agents/skills/gddy/reference/api.md Outdated
Comment thread .agents/skills/gddy/reference/api.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread plugins/godaddy-cli/.claude-plugin/plugin.json Outdated
Address second round of PR review feedback: point to gddy guide
domain-purchase / --search / tree / guide instead of duplicating
CLI docs, drop the buggy --reason "required" claim (DEVEX-884), trim
repeated godaddy/gddy disambiguation, and de-jargon "Good-as-Gold".
The godaddy CLI has no external customers and none once it merges
with gddy, so publishing an agent skill for it now just means
retracting it later. Per jpage-godaddy's review, ship only the gddy
skill: rename the plugin to gddy, drop the godaddy-cli skill and its
symlink, and revert .agents/skills/godaddy-cli/SKILL.md to unchanged.
@jpage-godaddy jpage-godaddy requested a review from Copilot July 15, 2026 00:52
opensource@godaddy.com didn't correspond to any real address in the
repo. SECURITY.md and CODE_OF_CONDUCT.md both use oss@godaddy.com as
the actual GoDaddy OSPO contact.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Claude Code plugin marketplace metadata and an agent skill package for the gddy CLI, plus documentation pointers from the repo root to help AI coding agents install/use the skill.

Changes:

  • Introduces a Claude plugin marketplace definition and a gddy plugin manifest.
  • Adds a gddy agent skill (SKILL + reference docs) describing install/auth, domain purchase, and DNS workflows.
  • Updates the root README to surface “AI coding agent” installation guidance.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
README.md Adds an “AI coding agent” installation section linking to the gddy skill docs.
plugins/gddy/.claude-plugin/plugin.json Defines the Claude plugin manifest for gddy.
.claude-plugin/marketplace.json Adds a marketplace entry listing the gddy plugin source.
.agents/skills/gddy/SKILL.md Adds the main skill instructions and operational guidance for using gddy.
.agents/skills/gddy/reference/errors-and-limits.md Adds reference material for error envelopes, retries, and rate limiting.
.agents/skills/gddy/reference/api.md Adds raw HTTP fallback notes and links to OpenAPI specs.
.agents/skills/gddy/README.md Adds one-line install instructions for Claude Code and npx skills.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Comment thread .claude-plugin/marketplace.json
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/SKILL.md Outdated
Comment thread .agents/skills/gddy/reference/api.md Outdated
Comment thread .agents/skills/gddy/README.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.

Comment thread README.md
Comment thread .agents/skills/gddy/SKILL.md
Comment thread .agents/skills/gddy/reference/api.md Outdated
@dkoopman-godaddy dkoopman-godaddy changed the title Add Claude Code plugin marketplace and agent skills for godaddy/gddy CLIs Add Claude Code plugin marketplace and agent skill for the gddy CLI Jul 15, 2026
- SKILL.md: drop stray "The" before inline command, fix subject-verb
  agreement in "Domain purchase is a multi-step workflow"
- api.md: correct $GODADDY_PAT to $GDDY_PAT to match SKILL.md and the
  gddy CLI's actual env var (verified via `gddy --help`/`gddy pat --help`)
- README.md: replace --agent claude-code example with an <agent>
  placeholder so the "any other agent" section isn't self-contradictory
It's a valid --agent value, just not the one shown in the command itself.
Matches the metadata fields present on the repo's other skills
(godaddy-cli, cli-design).
@jpage-godaddy jpage-godaddy merged commit a2eb44a into godaddy:main Jul 15, 2026
3 checks passed
@dkoopman-godaddy dkoopman-godaddy deleted the add-claude-plugin-and-skills-support branch July 15, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants