What is ds-match-api-client?

A command that compares an API client with an OpenAPI specification, a machine-readable description of an HTTP API and its data formats.

Use it to check the Python and TypeScript clients against the project's OpenAPI file and identify implementation gaps or inconsistencies.

It finds missing API endpoints, extra client methods, incorrect parameters, mismatched response types, and wrong HTTP methods.

How rossumai/rossum-agents configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to rossumai/rossum-agents. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/rossumai/rossum-agents/master/.claude/commands/ds-match-api-client.md

Clone the repo

git clone --depth 1 https://github.com/rossumai/rossum-agents

Made for: Claude Code.

Wrote 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.

README.md

[![agentmods](https://agentmods.dev/badge/commands/rossumai/rossum-agents/ds-match-api-client.svg)](https://agentmods.dev/commands/rossumai/rossum-agents/ds-match-api-client)

Your own site

<a href="https://agentmods.dev/commands/rossumai/rossum-agents/ds-match-api-client"><img src="https://agentmods.dev/badge/commands/rossumai/rossum-agents/ds-match-api-client.svg" alt="Measured on agentmods" height="20"></a>

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 552 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

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.00000	$0.00552
Opus 5	$0.00000	$0.00276
Sonnet 5	$0.00000	$0.00110
Haiku 4.5	$0.00000	$0.00055

Measured 7d ago against content hash 92374ac5a8e8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

ds-match-api-client scanned grade A with 0 findings 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 7d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/commands/ds-match-api-client.md · 68 lines

How it starts

The opening of the file, as written. The whole thing — 68 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Match API Client to OpenAPI Spec

Goal: Verify API client coverage matches OpenAPI specification - no missing endpoints, no unnecessary implementations.

Scope

Input	Files to Analyze
OpenAPI spec	`rossum-agent/rossum_agent/api/openapi.json`
Python client impl	`rossum-agent-client/rossum_agent_client/client.py`
Python models	`rossum-agent-client/rossum_agent_client/models/`
TS client impl	`rossum-agent-client-ts/src/` (functions, types, generated types)

What to Check

Category	Criteria
Missing endpoints	API paths in spec without client methods
Orphan methods	Client methods not backed by spec endpoints
Parameter mismatch	Client params don't match spec (required/optional, types)
Response models	Client response types align with spec schemas
HTTP methods	Client uses correct method (GET/POST/DELETE) per spec

Approach

Step	Action
Parse spec	Extract all paths, methods, parameters, schemas from `rossum-agent/rossum_agent/api/openapi.json`
Scan client	Identify all API methods, their HTTP calls, and parameters
Map	Create endpoint-to-method mapping
Diff	Identify gaps in both directions
Report	Output findings per category

Output Format

## API Client Coverage Report

### Missing Endpoints (in spec, not in client)
- [ ] `POST /api/endpoint` - description from spec

### Orphan Methods (in client, not in spec)
- [ ] `client.method_name()` - calls `POST /unknown`

### Parameter Mismatches
- [ ] `client.method()` - missing required param `x` from spec
- [ ] `client.method()` - extra param `y` not in spec

### Type Mismatches
- [ ] `client.method()` returns `X`, spec defines `Y`

TS Client (rossum-agent-client-ts)

The TS client's types are auto-generated from the same OpenAPI spec. Verify:

Check	What to verify
Generated types fresh	`src/generated.ts` matches current `openapi.json` — run `npm run generate` and diff
Client functions	Functions in `src/` cover all spec endpoints
SSE event types	`SSEEvent` union covers all SSE event models in spec

Read the full file on GitHub · 68 lines

Changes

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.

7d ago First seen · 68 lines · 0 tokens per session scan A 92374ac5a8e8

Subscribe to this mod's changes

ds-match-api-client is a command published in the GitHub repository rossumai/rossum-agents (11 stars, last pushed 7d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 552 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Backend and APIs

init

Initialize configurations for Supabase local development.

fcakyon/claude-codex-settings · 0 tokens

http-service

Build, review or debug a Bun HTTP service. Loads the http-service skill, then works the task through its workflow.

MadAppGang/magus · 27 tokens

start-10-1

A guided lesson on setting up clasp, a command-line tool for managing Google Apps Script projects, and connecting it to Google’s Apps Script API.

minicoohei/ai-agent-camp · 2 tokens

api-contract-review

Review an API contract (endpoints, request/response shapes, error codes, auth model) BEFORE implementation for naming consistency, versioning, pagination, idempotency, and alignment with existing endpoints. Distinct from review-hard (post-implementation risk) and repo-consistency-sweep (pattern matching on written…

Mozurok/fhorja.dev · 100 tokens

build

Discover an AI Gateway's models and MCP tools, retrieve a credential, and integrate them into your app — call a model, connect MCP tools, or scaffold a runnable agent.

Azure/ai-gateway · 35 tokens

fastapi

FastAPI application design and implementation conventions. Use this skill when building, updating, or reviewing FastAPI services, routers, dependencies, request/response schemas, streaming endpoints, or API tests. Trigger on FastAPI-specific work such as path operation design, dependency injection, response models…

mfmezger/ai_agent_dotfiles · 84 tokens

rossum-agents: Command for Claude Code