api-contract-review

Identify API contract deviations across Razor Pages, Minimal APIs, and HTMX endpoints.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/nhahoang1909/MarketNest --skill api-contract-review-nhahoang1909
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-contract-review
Source: https://github.com/nhahoang1909/MarketNest/tree/main/.claude/skills/api-contract-review
Command: npx skills add https://github.com/nhahoang1909/MarketNest --skill api-contract-review-nhahoang1909

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill scans and reviews the MarketNest endpoint layer to enforce consistent HTTP status conventions, RFC 7807 Problem Details compliance, HTMX response contracts, and robust Minimal API patterns.

Core Features & Use Cases

  • Enforces HTTP status code conventions for Create/Read/Update/Delete operations and returns appropriate ProblemDetails when errors occur.
  • Validates Problem Details structure and correlationId usage across Razor Pages, Minimal APIs, and exception handling middleware.
  • Verifies FluentValidation wiring and automatic validation via MediatR pipeline to minimize manual validation logic.
  • Checks HTMX endpoint patterns, anti-forgery usage, and HX-Trigger/headers for correct partial updates.
  • Generates an actionable fix report with ready-to-adopt code patterns and OpenAPI metadata documentation suggestions.
  • Useful for CI/code-review workflows, security audits, and onboarding new endpoint code.

Quick Start

Use this skill to audit your MarketNest API contracts and generate a prioritized report of fixes.

Frequently Asked Questions about api-contract-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit API contracts for consistent HTTP status codes in ASP.NET Core?

Audit API contracts by scanning Razor Pages, Minimal APIs, and HTMX endpoints to enforce consistent HTTP status conventions and return appropriate ProblemDetails when errors occur. This validates Create/Read/Update/Delete operations against seven rule groups.

How do I validate RFC 7807 Problem Details compliance across Minimal APIs and Razor Pages?

Validate RFC 7807 Problem Details compliance by checking the error structure and correlationId usage across ASP.NET Core endpoints and exception handling middleware. This ensures consistent error formats and proper HTMX response contracts.

How do I wire FluentValidation with MediatR pipeline for automatic API validation?

Wire FluentValidation with MediatR pipeline to enable automatic validation, minimizing manual validation logic. The skill verifies this configuration and checks HTMX endpoint patterns, anti-forgery usage, and HX-Trigger headers for correct partial updates.

Can I use this API contract review for ASP.NET Core 10.x projects using HTMX patterns?

Yes, you can use this API contract review for ASP.NET Core 10.x projects using HTMX patterns, FluentValidation pipelines, and MediatR. It audits endpoint implementations and generates actionable fix reports with ready-to-adopt code snippets and OpenAPI metadata suggestions.

What is the best way to generate actionable fix reports for HTMX endpoint deviations?

Generate actionable fix reports for HTMX endpoint deviations by validating implementations against seven rule groups. The process returns a structured, ready-to-fix set of guidance including code snippets and OpenAPI metadata documentation suggestions for CI/code-review workflows.

Why does my Minimal API return inconsistent error formats during endpoint audits?

Inconsistent error formats during endpoint audits occur when API implementations deviate from standard HTTP status conventions and RFC 7807 Problem Details compliance. The skill identifies these deviations and provides ready-to-adopt code patterns to enforce consistency.