api-contract-validator SKILL.md skillA

api-contract-validator from ninjasln-labs/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ninjasln-labs/agent-skills/api-contract-validator@v1.1.1

Pins v1.1.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ninjasln-labs/agent-skills
Path
api-contract-validator/SKILL.md
Versions recorded
5
Latest version
v1.1.1, committed Sep 29, 2026
First version recorded
Aug 3, 2026
Size
16,988 bytes
Repository stars
3
License
none declared

Validate API responses against OpenAPI/Swagger specifications, JSON Schema definitions, and GraphQL schemas to prevent breaking changes. Use when checking whether an API change removes fields, changes types, or breaks backward compatibility; when validating responses against a published contract in CI; when detecting GraphQL schema breaking changes; or when reviewing consumer-driven contract tests.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# API Contract Validator Skill

You are an expert QA engineer specializing in API contract validation. When the user asks you to write, review, or plan API contract tests, follow these detailed instructions to systematically verify that API responses conform to their published specifications, that backward compatibility is maintained across versions, and that consumer expectations are always met.

## Core Principles

1. **Contract as source of truth** -- The OpenAPI specification or JSON Schema definition is the authoritative contract between API provider and consumer. Every response field, status code, and header must match the spec exactly, not approximately.
2. **Backward compatibility by default** -- New API versions must not remove existing fields, change field types, or alter response structures without explicit versioning. Additive changes are safe; subtractive changes break consumers.
3. **Consumer-driven validation** -- Contracts should reflect what consumers actually use, not just what the provider documents. Consumer-driven contract testing ensures that provider changes do not break real consumer expectations.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ninjasln-labs/agent-skills/api-contract-validator@sha256:d373eb4b0c277f4e

The line at the top of this page pins the label v1.1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mrl7jkg5rlbden3a.svg)](https://markdownregistry.com/a/art_mrl7jkg5rlbden3a)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 3, 2026 and Sep 29, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
v1.1.1 latest2026-09-29 0febb7a 16,988 BA view · diff
v1.0.12026-09-22 75c75c0 41,133 BA view · diff
v1.0.02026-09-07 571fb57 40,953 BA view · diff
git:20260803.cf548c92026-08-03 cf548c9 40,873 BA view · diff
git:20260803.88cd1672026-08-03 88cd167 40,870 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16988 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ninjasln-labs/agent-skills · 3 stars · license none declared · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mrl7jkg5rlbden3a
GET https://markdownregistry.com/api/v1/resolve?ref=ninjasln-labs/agent-skills/api-contract-validator
GET https://markdownregistry.com/api/v1/blob/d373eb4b0c277f4e932ed9b1e912d0982e70bd9eb7e2aeb9464d1d183eb24b2d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ninjasln-labs/agent-skills

accessibility-auditor SKILL.md skill
ninjasln-labs/agent-skills · accessibility-auditor/SKILL.md · Comprehensive WCAG 2.1 AA compliance testing combining automated axe-core scans with manual keyboard navigation and…
v1.2.0 · audit A · 3 stars
agent-dispatch SKILL.md skill
ninjasln-labs/agent-skills · agent-dispatch/SKILL.md · User-invoked only: run it when the user explicitly asks to hand work to an external agent CLI, never on your own…
v1.5.6 · audit A · 3 stars
architecture-patterns SKILL.md skill
ninjasln-labs/agent-skills · architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
v1.2.0 · audit A · 3 stars
audit-item SKILL.md skill
ninjasln-labs/agent-skills · audit-item/SKILL.md · Track audit/review findings as numbered issue files (audit-items/NNN-slug.md, under the directory the project keeps…
v1.1.0 · audit A · 3 stars
autonomous-investigation SKILL.md skill
ninjasln-labs/agent-skills · autonomous-investigation/SKILL.md · The evidence protocol behind recurring competitive and market investigation skills — market scans, competitive…
v1.2.0 · audit A · 3 stars
battle-card-builder SKILL.md skill
ninjasln-labs/agent-skills · battle-card-builder/SKILL.md · Research and draft a competitive battle card from public evidence — every claim labeled and sourced. Use when a rep…
v1.1.1 · audit A · 3 stars
cicd-pipeline SKILL.md skill
ninjasln-labs/agent-skills · cicd-pipeline/SKILL.md · Configure testing in CI/CD pipelines for GitHub Actions, Jenkins, and GitLab CI: shards, parallelization, wait-on…
v1.2.0 · audit A · 3 stars
code-review SKILL.md skill
ninjasln-labs/agent-skills · code-review/SKILL.md · Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code…
v1.1.0 · audit A · 3 stars
codebase-design SKILL.md skill
ninjasln-labs/agent-skills · codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
v1.0.1 · audit A · 3 stars
company-intel SKILL.md skill
ninjasln-labs/agent-skills · company-intel/SKILL.md · Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need…
v1.1.1 · audit A · 3 stars
competitive-analysis-process SKILL.md skill
ninjasln-labs/agent-skills · competitive-analysis-process/SKILL.md · Orchestrate a complete competitive analysis end to end: market landscape, product-level comparison, ability to fulfill…
v1.1.1 · audit A · 3 stars
competitive-intel-watch SKILL.md skill
ninjasln-labs/agent-skills · competitive-intel-watch/SKILL.md · Competitive Intel Watch: scheduled delta monitoring against a prior competitive snapshot. Use when tracking competitors…
v1.1.1 · audit A · 3 stars

Every file in ninjasln-labs/agent-skills

Other files named api-contract-validator

api-contract-validator SKILL.md skill
pramoddutta/aitesterblueprint4x · chapter_02_Prompt_Eng/prompt_templates/api_testing/api-contract-validator/SKILL.md · Compare observed HTTP API requests and responses with an OpenAPI or equivalent endpoint contract. Use when asked to…
v1.0.0 · audit A · 14 stars

Browse by kind, by grade A, or by owner.