developing-openapi-specs
Guide for contributing to the OpenAPI layer using processor pattern, complexity management, and functional programming. Use when adding endpoint factories, processors, parameter descriptions, reducing cyclomatic complexity, or fixing OpenAPI validation errors. Covers architecture patterns from user-service repository.
npx skills add majiayu000/claude-skill-registry --skill developing-openapi-specs --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Developing OpenAPI Specs **Guide for contributing to the OpenAPI layer** at `src/Shared/Application/OpenApi/`. This skill covers architecture patterns, complexity management techniques, and best practices for maintaining OpenAPI specifications while keeping code quality high. **Related Skills**: - [implementing-ddd-architecture](../implementing-ddd-architecture/SKILL.md) - Domain layer must stay pure; OpenAPI code belongs in Application layer ## When to Use This Skill - Adding new OpenAPI endpoint factories - Creating processors for spec transformation - Adding parameter descriptions or validation - Modifying OpenAPI generation logic - Fixing OpenAPI validation errors - Reducing cyclomatic complexity in OpenAPI code ## Architecture Overview The OpenAPI layer follows a **Processor Pattern** with clear separation of concerns: ``` src/Shared/Application/OpenApi/ ├── Builder/ # Schema and parameter builders ├── Factory/ │ ├── Endpoint/ # Custom endpoint factories │ ├── Request/ # Request body schemas │ ├── Response/ # Response schemas │ └── UriParameter/ # Path parameter factories ├── Processor/ # Spec transformation processors └── OpenApiFactory.php # Main coordinator ``` ### Key Pr
- When to Use This Skill
- Architecture Overview
- Key Principles
- Quick Pattern Reference
- Pattern 1: OPERATIONS Constant
- Pattern 2: Match Expression (Lower Complexity)
- Pattern 3: Functional Array Operations
- Pattern 4: Extract Methods (Keep Under 20 Lines)
- Complexity Target Metrics
- Quick Start Guide
- Adding a Processor
- Adding an Endpoint Factory
- Adding Parameter Descriptions
- Anti-Patterns to Avoid
make generate-openapi-spec # Generate spec make validate-openapi-spec # Validate with Spectral make phpinsights # Check quality scores make unit-tests # Run tests
What does the developing-openapi-specs skill do?
Guide for contributing to the OpenAPI layer using processor pattern, complexity management, and functional programming. Use when adding endpoint factories, processors, parameter descriptions, reducing cyclomatic complexity, or fixing OpenAPI validation errors. Covers architecture patterns from user-service repository.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill developing-openapi-specs --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.