api-conventions

Enforce ASP.NET Core API conventions for NewsParser controllers and endpoints.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/roromanenko/NewsParser --skill api-conventions-roromanenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-conventions
Source: https://github.com/roromanenko/NewsParser/tree/main/.claude/skills/api-conventions
Command: npx skills add https://github.com/roromanenko/NewsParser --skill api-conventions-roromanenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NewsParser API conventions for ASP.NET Core (.NET 10) ensure consistent architecture and maintainability when adding controllers, endpoints, DTOs, validators, or modifying auth/error-handling in the Api/ project.

Core Features & Use Cases

  • Enforces controller structure, routing, and authentication patterns.
  • Provides guidelines for DTOs, validators, and error handling.
  • Use case: when adding a new endpoint, you follow the documented conventions to maintain consistency.

Quick Start

Follow the documented controller templates and route conventions when adding or updating API code in Api/.

Frequently Asked Questions about api-conventions

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

FAQPage Schema
How do I structure ASP.NET Core controllers to follow consistent API conventions?

ASP.NET Core API conventions standardize controller structure by enforcing specific route naming, authentication patterns, and endpoint templates. This ensures architectural consistency when adding new controllers or modifying existing endpoints in your Api/ project.

What is the best way to handle validation in ASP.NET Core APIs using FluentValidation?

Validation in ASP.NET Core APIs is handled by integrating FluentValidation to validate DTOs. This approach enforces consistent error-handling patterns and ensures data integrity before processing requests within your controller endpoints.

How do I map DTOs to domain models in an ASP.NET Core API project?

DTO mapping in an ASP.NET Core API project uses static mappers to transform data transfer objects into domain models. This standardizes mapping patterns and maintains separation between API layers and internal business logic.

Does this API conventions approach work with .NET 10 projects?

Yes, these API conventions are specifically designed for ASP.NET Core .NET 10 projects. They provide the necessary guidelines for routing, authentication, and error-handling to maintain maintainable architecture in modern .NET environments.

When do I need to apply API conventions when modifying authentication or error-handling?

You need to apply API conventions whenever modifying authentication or error-handling logic within the Api/ project. This ensures that any updates to security patterns or error responses remain consistent with the established controller structure.