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 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/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<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="Reviewed on agentmods" width="80" 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.5 | $0.00040 | $0.01234 |
| Sonnet 5.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 1mo 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.
- 1mo 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 1mo ago), licensed MIT. It adds 101 tokens to every session and 3,084 once invoked, about $0.0004 per session on Opus 5.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
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-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-job-development
Guide for developing custom jobs in Salesforce B2C Commerce Job Framework. Use this when asked to create batch jobs, scheduled tasks, chunk-oriented processing, or task-oriented jobs.
sfcc-cartridge-development
Guide for creating, configuring, and deploying custom SFRA cartridges in Salesforce B2C Commerce. Use this when asked to create a new cartridge, set up a cartridge structure, or work with cartridge paths.
sfcc-forms-development
Guide for building, validating, securing, and persisting SFCC storefront forms (SFRA + SiteGenesis patterns). Use this when creating or troubleshooting form XML, controller handling, CSRF, and validation.
sfcc-script-evaluation
Guide for using the evaluatescript tool to execute JavaScript on SFCC instances via the script debugger.