Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/adadiamonds/agent-tools/ada-diamonds-apinpx skills add adadiamonds/agent-tools --skill ada-diamonds-apigit clone --depth 1 https://github.com/adadiamonds/agent-toolsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/adadiamonds/agent-tools/ada-diamonds-api)<a href="https://agentmods.dev/skills/adadiamonds/agent-tools/ada-diamonds-api"><img src="https://agentmods.dev/badge/skills/adadiamonds/agent-tools/ada-diamonds-api.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00101 | $0.03084 |
| Opus 5 | $0.00051 | $0.01542 |
| Sonnet 5 | $0.00020 | $0.00617 |
| Haiku 4.5 | $0.00010 | $0.00308 |
Grade A, and why
ada-diamonds-api scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
description: Reference for the Ada Diamonds public REST API (https://www.adadiamonds.com/api/v1) covering every endpoint, self-serve API keys and OAuth 2.1 scopes, the public sandbox key, rate limits, error shapes, versi How it starts
The opening of the file, as written. The whole thing — 229 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Ada Diamonds REST API
Base URL: https://www.adadiamonds.com/api/v1. All responses are JSON. All prices are US dollars as decimals.
Authoritative machine descriptions (prefer these over memory when generating code):
- OpenAPI 3.1:
https://www.adadiamonds.com/openapi.json - RFC 9727 API catalog:
https://www.adadiamonds.com/.well-known/api-catalog - Human docs:
https://www.adadiamonds.com/developers(also served as markdown withAccept: text/markdown) - Agent guide:
https://www.adadiamonds.com/agents.md - Site index:
https://www.adadiamonds.com/llms.txt
Quickstart (no credential)
curl "https://www.adadiamonds.com/api/v1/diamonds?shape=Oval&min_carat=1&max_price=4000&sort=price_asc"
Endpoints
| Method and path | Returns | Scope |
|---|---|---|
GET /diamonds |
Available loose lab diamonds | public |
GET /diamonds/{id} |
One diamond, by slug or grading report number | public |
GET /engagement-rings |
Engagement ring settings (price excludes center stone) | public |
GET /engagement-rings/{slug} |
One setting, by slug or SKU (AD-066 or 066) |
public |
GET /jewelry |
Fine jewelry | public |
GET /jewelry/{slug} |
One piece, by slug or SKU | public |
GET /knowledge-base |
Published guides (q matches title and summary) |
public |
GET /knowledge-base/{slug} |
One guide, body as markdown | public |
GET /showrooms |
Showrooms and remote consultation options | public |
POST /consultations |
Request a jeweler consultation | appointments:write |
POST /keys |
Issue a self-serve API key | public |
POST /batch |
Up to 20 GET requests in one round trip | public |
POST /exports |
Queue a full catalog export; 202 with a job to poll | public |
GET /jobs/{id} |
Status of an export job (queued or succeeded) |
public |
GET /exports/{id} |
Download a finished export (NDJSON or JSON) | public |
Outside /api/v1, on the site root:
| Method and path | Returns |
|---|---|
GET https://www.adadiamonds.com/ask?query=... |
NLWeb natural-language answer over the catalog and guides (JSON, or SSE with streaming=true) |
GET https://www.adadiamonds.com/.well-known/agent-card.json |
A2A agent card; JSON-RPC endpoint at /a2a |
GET https://www.adadiamonds.com/auth.md |
Agent authentication walkthrough |
GET https://www.adadiamonds.com/pricing.md |
Machine-readable pricing rules |
GET <any page>?mode=agent |
Structured agent view of a page instead of marketing HTML |
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 229 lines · 101 tokens per session scan A a6eef1afc8eb
ada-diamonds-api is a skill published in the GitHub repository adadiamonds/agent-tools (2 stars, last pushed 8d ago), licensed MIT. It adds 101 tokens to every session and 3,084 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
seller-research
Use when researching a merchant, storefront, marketplace seller, or merchant of record for a buying decision, especially when identity, refund terms, fulfillment, counterfeit risk, domain history, or independent buyer outcomes are uncertain.
Product Photoshoot Workflow
Multi-angle product imagery workflow. Use when the user wants to "shoot a product", "make e-commerce product images", "product photography set", "电商产品图", "产品多角度图", "brand product visuals", or provides a single product photo and asks for marketing-ready variations. Produces 4 distinct directions (lifestyle scene, macro…
sfcc-performance
Performance optimization strategies for Salesforce B2C Commerce Cloud including caching, efficient data retrieval, index-friendly APIs, and job optimization. Use when asked about SFCC performance, caching strategies, or optimization.
sfcc-ocapi-hooks
Guide for implementing OCAPI hooks in Salesforce B2C Commerce. Use this when asked to create OCAPI hooks, extend API endpoints, validate API requests, or modify API responses.
sfcc-scapi-hooks
Guide for implementing SCAPI hooks in Salesforce B2C Commerce. Use this when asked to create SCAPI hooks, extend Shopper API endpoints, validate API requests, or modify API responses for headless commerce.
sfcc-sfra-scss
Best practices for styling and theming SFRA storefronts using SCSS. Use when asked to create style overrides, theming, responsive layouts, or CSS customizations in SFCC.