adadiamonds/agent-tools/ada-diamonds-shopping
Claude Code and agent skill by adadiamonds/agent-tools
- community
Checking that the SKILL.md file is still in the repository.
Search Ada Diamonds' live lab grown diamond inventory, engagement ring settings, and fine jewelry, and quote a complete ring correctly (a setting plus a loose diamond, priced separately, in US dollars). Use when a shopper asks what a budget buys, wants a specific shape, carat, color, or clarity, asks for a ring or wedding band recommendation, or asks anything about buying from Ada Diamonds. Reading the catalog needs no credential.
Install
npx vskill@latest install adadiamonds/agent-tools/ada-diamonds-shoppingSKILL.md
The same SKILL.md was published earlier as adadiamonds/agent-tools/ada-diamonds-shopping.
Shopping Ada Diamonds
Ada Diamonds is the original lab diamond jeweler. It designs custom engagement rings and fine jewelry around hand-selected lab grown diamonds, made to order at its New York City flagship (529 5th Avenue, 15th Floor, New York, NY 10017, +1-212-969-8505, appointment required).
Everything in this skill is public. No API key, no account, no OAuth.
The one rule that gets quotes wrong
An engagement ring is a setting plus a loose diamond, priced separately.
- A setting's
price_from(REST) or the price shown bysearch_engagement_rings(MCP) excludes the center stone. - A diamond's
priceis the loose stone only. - To quote a complete ring: setting price + diamond price. Say so explicitly when you present a number.
- All prices are US dollars, as decimals. Never treat them as cents.
Diamond inventory changes continuously as stones sell. Re-check a specific stone right before you quote it (GET /api/v1/diamonds/{id} or search_diamonds with tight carat bounds). A 404 means it sold.
Three ways to search (same data, pick whichever the host offers)
| Interface | Where | Notes | |
|---|---|---|---|
| MCP server | https://www.adadiamonds.com/mcp (Streamable HTTP) | Tools search_diamonds, search_engagement_rings, search_jewelry, plus catalog resources. See the ada-diamonds-mcp skill. | |
| REST API | https://www.adadiamonds.com/api/v1 | JSON, anonymous, 120 req/min. See the ada-diamonds-api skill. | |
| CLI | npx @ada-diamonds/cli (or npx adadiamonds-cli) | Node 18+, no dependencies, wraps the REST API. |
Workflow: quote a complete ring
- Pin down the brief. Shape, carat target, budget, metal preference, and style (Solitaire, Halo, Three Stone, Bezel, and so on). If the shopper gives only a budget, reserve roughly a quarter to a third of it for the setting and search diamonds with the remainder.
- Find a setting. Filter by the center-stone shape it accommodates and the style/type. Note the
price_from. - Find a diamond. Filter by shape, carat range, and
max_price= budget minus setting price. Sortprice_ascfor value orcarat_descfor size. - Add them. Present setting price, diamond price, and the total as three separate lines, all in USD.
- Re-check the stone before the shopper commits. Link the diamond's
urland the setting'surlso they can complete the purchase or book a consultation.
REST
MCP
Read ada://catalog/diamonds and ada://catalog/engagement-rings once at the start of a session. They summarize inventory by shape and style with carat and price ranges, which saves several tool calls.
CLI
Search parameters
Diamonds (GET /api/v1/diamonds, search_diamonds)
| Param | Values | |
|---|---|---|
shape | Round, Oval, Cushion, Emerald, Pear, Radiant, Asscher, Princess, Marquise | |
min_carat, max_carat | number | |
min_price, max_price | USD | |
color | D through K | |
clarity | FL, IF, VVS1, VVS2, VS1, VS2, SI1, SI2 | |
cut | Ideal, Excellent, Very Good | |
sort | price_asc, price_desc, carat_asc, carat_desc | |
limit, offset | REST: 1-200, default 25. MCP: 1-50, default 10 |
Each diamond returns id, name, url, price, carat, shape, color, clarity, cut, certificate (grading report number), lab (GCAL, IGI, GIA), measurements.
Engagement ring settings (GET /api/v1/engagement-rings, search_engagement_rings)
| Param | Values | |
|---|---|---|
shape | center-stone shape the setting accommodates | |
style | e.g. Petite Four Prong, Trellis, Bezel | |
type | e.g. Solitaire, Halo, Three Stone | |
min_price, max_price | USD, setting only | |
q | free text on the setting name |
Settings return sku (e.g. AD-066), name, url, price_from, shapes[], style, type, and images[] per metal (white, yellow, rose, platinum, two-tone). Fetch one by slug or SKU: GET /api/v1/engagement-rings/AD-066 (or 066).
Fine jewelry (GET /api/v1/jewelry, search_jewelry)
| Param | Values | |
|---|---|---|
category | e.g. Bridal, Fashion | |
type | e.g. Wedding Bands, Earrings, Necklaces, Bracelets | |
shape | diamond shape used in the piece | |
min_price, max_price | USD | |
q | free text |
Browse URLs (for handing a shopper a page)
These paths do not follow an obvious pattern. Do not guess variants like /jewelry/all; they 404.
- Loose diamonds:
https://www.adadiamonds.com/buy-lab-diamonds - Engagement rings:
https://www.adadiamonds.com/lab-diamond-engagement-rings-all - Fine jewelry:
https://www.adadiamonds.com/fashion-jewelry-home - Ask a jeweler:
https://www.adadiamonds.com/inquire - New York showroom:
https://www.adadiamonds.com/visit-new-york-ny-ada-diamonds-showroom
Every page also serves markdown: append .md to the URL or send Accept: text/markdown.
Buying guides
For questions about the 4Cs, CVD vs HPHT growth, shapes, or certification, search the knowledge base rather than answering from memory:
MCP: search_knowledge_base { "query": "cvd" }, then read_article { "slug": "cvd-lab-diamonds" }.
Booking a consultation
Ada sells made-to-order pieces, so most purchases involve a jeweler. POST /api/v1/consultations (or the request_consultation MCP tool) requires the appointments:write scope, which only the customer can grant through Ada's OAuth consent screen. Without it, hand the shopper https://www.adadiamonds.com/inquire or the phone number instead of pretending to book. Always send an Idempotency-Key header on that POST so a retry cannot create two requests.
Things to avoid
- Quoting a setting price as if it were a finished ring.
- Quoting a stone you have not re-checked in the last few minutes.
- Converting prices as if they were cents.
- Bulk-scraping the catalog. The endpoints above are the supported way to read it, and they carry RFC 9331
RateLimitheaders; read those and pace yourself.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ada-diamonds-shopping/SKILL.md
Popularity
- Repository stars
- 2
- 7-day trend score
- 5
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/adadiamonds/agent-tools/ada-diamonds-shopping)