Wrap the entire RubyGems.org HTTP API into typed Go interfaces. Claude Code & Codex can install, query, and publish gems in minutes — just paste a prompt.
One prompt to rule them all
Copy the block below, paste it into Claude Code or Codex, replace the one line that describes what you want — then sit back. The agent installs the SDK, reads the docs on this site if it needs to, writes the code, handles errors, and runs it for you.
Use the rubygems-skills Go SDK (github.com/scagogogo/rubygems-skills) to
interact with the RubyGems.org API in this project.
WHAT I WANT TO DO:
<Describe your task in one line — e.g. "fetch the rails gem and its latest
5 versions", "publish mygem-0.1.0.gem", "audit these 20 gems in bulk".>
HOW TO DO IT (follow this exactly):
1. Add the dependency: go get github.com/scagogogo/rubygems-skills@latest
2. Read the SDK's official docs at https://rubygems-skills (or the /ai-agents
and /api pages on this site) ONLY IF you need a method or field name you
don't already know. The key facts for most tasks:
- Read client: repo := repository.NewRepository()
- Write client: w := repository.NewWriteRepository(
repository.NewOptions().SetToken(os.Getenv("RUBYGEMS_API_KEY")))
- Data structs live in pkg/models and mirror the API JSON 1:1.
- Error helpers: repository.IsNotFound / IsRateLimited / IsUnauthorized.
- China mirrors: repository.NewRubyChinaRepository() etc.
- If ruby/gem isn't installed and my task needs to RUN them, use
install.NewInstaller().Install(ctx) from pkg/install to auto-install.
3. Write idiomatic Go for my task. Handle errors with the helpers above.
Don't hardcode URLs — use the constructors.
4. Run `go run .` (or `go run main.go`) and show me the output.
5. If it fails to build or run, read the error, fix the code, and re-run.
Iterate until it works. Don't stop at the first error.
If my task needs auth (publish, owners, webhooks), ask me to set
RUBYGEMS_API_KEY in the env before step 4. Otherwise proceed without asking.Just paste and wait
You don't read any other docs. The agent reads this website when it needs to, understands the SDK, writes the code, installs dependencies, runs it, fixes its own errors, and shows you the result. Copy → paste → done.
The Copy-Paste Prompts page has task-specific blocks — bootstrap a query, bulk-fetch many gems, publish a .gem, auto-install Ruby, manage webhooks, run a dependency audit — each tuned so the agent needs zero clarification.
→ Get the full prompt collection
AI coding agents (Claude Code, Codex, Cursor, etc.) are great at writing Go — but when you ask them to "use the RubyGems API", they hit the same walls every time:
gem or ruby, it stalls because the binary isn't on the machine.rubygems-skills fixes all four in one typed, tested, agent-friendly module.
→ Read the full "Why" breakdown
The SDK turns every RubyGems HTTP endpoint into a typed Go interface method. You call repo.GetPackage(ctx, "rails") and get back a *models.PackageInformation struct — no JSON parsing, no URL construction, no error-code guessing.
For write operations (publish, yank, owners, webhooks), the WriteRepository interface wraps the authenticated endpoints. And pkg/install adds a cross-platform auto-installer so the agent can provision Ruby itself when needed.
→ Deep dive into the architecture