Agent skill · data analytics · jeremylongshore

mistral-common-errors

Diagnose Mistral authentication, validation, throttling, model, transport, and provider failures without unsafe retries. Use when an integration fails. Trigger with "Mistral error", "fix a Mistral 429", or "debug a failed Mistral request".

Why this skill is useful

Provides specific troubleshooting commands and error handling patterns for Mistral AI that the AI wouldn't reliably generate on its own.

What it needs

Requires mistral installed locally. Requires mistral account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

Mistral Error Triage Overview Classify failure before changing code or replaying work. Separate local configuration, invalid request, account policy, rate boundary, transient provider, and application parsing failures. Prerequisites A timestamp, environment, operation, endpoint class, client pin, and sanitized error. The application deadline, idempotency class, and retry budget. Current endpoint and workspace-limit documentation. Current Contract HTTP and client errors are evidence, not universal retry instructions. Workspace limits are shared across keys and current dimensions belong to the Admin Panel. Authentication Never request or reproduce a key. Confirm only secret-reference resolution, expected host, and environment. Instructions 1. Freeze automatic retries and identify ambiguous side effects or state. 2. Normalize status, request ID, endpoint, model, client, attempts, and elapsed time. 3. Validate the request locally against the current endpoint contract. 4. Check account, model access, current usage limits, and billing with authorized evidence. 5. Classify and choose bounded mitigation: fix config/input, wait, reduce demand, or escalate. 6. Reproduce once with synthetic data only when approved; revert temporary diagnostics. Tool Discipline Use Read, Glob, and Grep to inspect code, locks, configuration, tests, and evidence. Use Write and Edit only for approved repository changes. Invocation alone does not authorize network calls, paid usage, uploads, stateful resources, admin mutations, deployments, or deletion. Approval Boundaries Require approval for replay, limit/spend increase, model substitution, upgrade, or support submission. Never blindly retry stateful work. Error Handling Repeated 401 calls will not repair a revoked key. Aggressive retries after 429 amplify queued demand. A timeout after submission may be ambiguous; reconcile before repeating. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/mistral-common-errors

View the source on GitHub

Browse the @skills marketplace