add-api

Scaffold OMS backend API endpoints with DTOs, OrgId-scoped services, and controllers.

16|9|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/omni-system-creator/omni --skill add-api-omni-system-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-api
Source: https://github.com/omni-system-creator/omni/tree/main/.claude/skills/add-api
Command: npx skills add https://github.com/omni-system-creator/omni --skill add-api-omni-system-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Efficiently scaffolds a new API endpoint in the OMS backend by standardizing DTOs, services, and controllers to reduce boilerplate and ensure consistent ownership and security patterns.

Core Features & Use Cases

  • Scaffolds DTOs: Create {EntityName}Dto, Create{EntityName}Dto, Update{EntityName}Dto, and optional Query DTOs.
  • Generates service with OrgId scoping, AutoInject, and async methods for CRUD operations.
  • Builds controller with standard API routes and authorized access, enforcing Org ownership checks on queries and mutations.
  • Ensures all data access is filtered by current OrgId and supports transactional operations for multi-table changes.
  • Provides XML documentation and error handling scaffolds.

Quick Start

Follow the steps to scaffold a new API endpoint: name the entity, generate DTOs, implement the service with OrgId filtering and AutoInject, create the controller, and wire everything together.

Frequently Asked Questions about add-api

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

FAQPage Schema
How do I scaffold a secure API endpoint with OrgId filtering in a C# backend?

To scaffold a secure API endpoint with OrgId filtering, this tool generates standardized DTOs, async services with AutoInject, and authorized controllers. It enforces Org ownership checks on all data queries and mutations to ensure multi-tenant security.

What is the best way to reduce boilerplate when creating CRUD DTOs for a .NET API?

The best way to reduce boilerplate when creating CRUD DTOs is automatically generating Create, Update, and Query DTOs. This ensures consistent naming and structure while minimizing manual coding effort for standard backend operations.

How do I ensure transactional safety for multi-table changes in an Entity Framework API?

Transactional safety for multi-table changes in an Entity Framework API is ensured by scaffolding services with async operations and transactional support. This prevents partial data updates during complex multi-table mutations.

Does this API scaffolding tool support async operations and avoid blocking calls?

Yes, this API scaffolding tool fully supports async operations and explicitly avoids blocking calls. It generates service implementations and controllers designed for non-blocking, asynchronous CRUD workflows.

Can I generate XML documentation and error handling scaffolds for my new API controller?

Yes, you can generate XML documentation and error handling scaffolds alongside your new API controller. The tool automatically includes these standard scaffolds to improve code maintainability and API consumer integration.