Does this replace standard code linters?

No, this skill focuses specifically on architectural boundaries and contract integrity across files, whereas standard linters typically focus on local syntax and code style within a single file.

Can I target specific parts of my application?

Yes, the skill supports a 'domain-aware' mode that allows you to restrict scans to specific paths, such as specific microservices or domain folders, and tags findings accordingly.

What is 'layer leakage' in API design?

Layer leakage occurs when implementation details from one layer, such as HTTP request objects or database entities, are exposed or used directly in another layer like business services, violating the principle of separation of concerns.

How does this skill calculate its audit score?

It uses a penalty-based formula where critical, high, medium, and low severity issues subtract points from a base score of 10, while providing diagnostic sub-scores for compliance, completeness, and quality.

API Contract Auditor

Name: API Contract Auditor
Author: levnikolaevich

bylevnikolaevich

•

147

•

API Development

Audits API contracts and service boundaries to ensure clean architecture, prevent layer leakage, and enforce consistent DTO patterns.

The ln-643-api-contract-auditor is a specialized worker designed to maintain architectural integrity at the service layer. It automatically scans codebase boundaries to detect critical issues such as ORM entity leakage to the API, missing Data Transfer Objects (DTOs), and inconsistent error handling. By providing a structured analysis with penalty-based scoring across compliance, completeness, quality, and implementation, it helps development teams enforce best practices and prevent transport-level details from bleeding into business logic, ensuring a robust and maintainable backend.

Key Features

01Detects layer leakage and transport-level types in service signatures

02Provides automated architectural scoring and diagnostic sub-scores

03Standardizes error handling patterns across service boundaries

04147 GitHub stars

05Identifies missing DTOs for complex method parameters and groupings

06Flags direct ORM entity leakage to API response layers

Use Cases

01Automating architectural reviews during CI/CD or code merge processes

02Refactoring legacy backends to enforce clean separation of concerns

03Ensuring new API endpoints adhere to domain-driven design (DDD) patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add levnikolaevich/claude-code-skills ln-643-api-contract-auditor

For use in Claude.ai and ChatGPT

Download Skill