smithery/mitkox

net-web-api

Scaffold and configure ASP.NET Core Web API with best practices

Installation

$ npx skills add smithery/mitkox --skill net-web-api

Also in this package

Other skills from smithery/mitkox · top by installs.

npx skills add smithery/mitkox

Browse all from smithery/mitkox

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Declared

Skill metadata

Parsed from SKILL.md frontmatter.

Version8.0
LicenseMIT
Compatibilityopencode
Declared agents opencode
More metadata
audience
.net-developers
framework
aspnetcore
version
8.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,152 B
  • docs SUMMARY.md 82 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

What I Do

I help you create production-ready ASP.NET Core Web API projects with:

  • Clean architecture structure
  • Proper dependency injection
  • Swagger/OpenAPI documentation
  • Global exception handling
  • Request/response logging
  • API versioning
  • Health checks
  • CORS configuration

When to Use Me

Use this skill when:

  • Creating a new Web API project
  • Setting up API infrastructure
  • Adding middleware and filters
  • Configuring API best practices

What I Create

Project Structure:

src/{ProjectName}.Api/
├── Controllers/
├── Filters/
│   ├── GlobalExceptionFilter.cs
│   ├── ValidationFilter.cs
│   └── ApiKeyFilter.cs
├── Middleware/
│   ├── RequestLoggingMiddleware.cs
│   └── ErrorHandlingMiddleware.cs
├── Extensions/
│   ├── ServiceCollectionExtensions.cs
│   └── ApplicationBuilderExtensions.cs
├── Models/
│   └── ErrorResponse.cs
├── Program.cs
└── appsettings.json

Key Features:

  • Program.cs configured with:

- Controllers and minimal APIs - Swagger/OpenAPI - Health checks - CORS - Global exception handling - Request validation - API versioning

  • GlobalExceptionFilter.cs handles exceptions
  • ValidationFilter.cs validates requests
  • RequestLoggingMiddleware.cs logs requests/responses

Best Practices I Follow

  1. Use minimal APIs for simple endpoints
  2. Implement proper HTTP status codes
  3. Validate all inputs
  4. Use DTOs for API models
  5. Implement proper error responses
  6. Add XML comments for Swagger
  7. Configure health checks
  8. Use API versioning from start

Example Usage

Create a new ASP.NET Core Web API project with:
- Swagger/OpenAPI documentation
- Health checks endpoint
- Global exception handling
- Request validation
- API versioning
- CORS configuration

I will generate all necessary files following .NET 8 best practices.