Is this skill restricted to DDD projects?

While highly effective for Domain-Driven Design, it is valuable for any PHP project aiming to improve encapsulation, maintainability, and software quality through better decoupling.

Does it offer guidance on how to fix the leaks?

Yes, every report includes a 'Refactoring Strategies' section that demonstrates how to replace leaky types with clean abstractions like DTOs, primitive types, or custom interfaces.

What is a leaky abstraction in PHP?

A leaky abstraction occurs when implementation details, such as a specific ORM type or framework component, are exposed through an interface, forcing the calling code to depend on infrastructure rather than just the contract.

How does this skill detect architectural leaks?

It uses advanced pattern matching and grep-based analysis to locate framework namespaces, database types, and HTTP objects inside protected architectural layers like Domain and Application.

Which PHP frameworks does it support?

It is designed to identify common leaks from major PHP ecosystems including Symfony, Laravel, Doctrine, Guzzle, and API Platform.

PHP Leaky Abstraction Detector

Name: PHP Leaky Abstraction Detector
Author: dykyi-roman

bydykyi-roman

•

セキュリティとテスト

Analyzes PHP codebases to identify and resolve implementation details leaking through architectural boundaries.

This skill acts as an architectural auditor for PHP projects utilizing Domain-Driven Design (DDD), Clean Architecture, or Hexagonal patterns. It systematically scans your codebase to detect 'leaky abstractions'—instances where infrastructure or framework details, such as Doctrine collections, Symfony HTTP components, or database-specific exceptions, seep into the domain or application layers. By identifying these violations of encapsulation, it helps developers maintain strict architectural boundaries, ensuring that business logic remains pure, testable, and decoupled from external dependencies.

主な機能

01Identifies infrastructure-specific return types and parameters in core interfaces

02Detects framework leakage from Symfony, Laravel, and Doctrine within the Domain layer

03Audits serialization attributes and ORM annotations within domain entities

0445 GitHub stars

05Scans for untranslated database or HTTP exceptions crossing layer boundaries

06Generates structured reports with severity levels and actionable refactoring strategies

ユースケース

01Auditing legacy PHP projects transitioning toward Clean Architecture or DDD

02Automating code reviews to prevent new features from introducing tight coupling

03Preparing for framework migrations by identifying hidden infrastructure dependencies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-leaky-abstractions

For use in Claude.ai and ChatGPT

Download Skill