Index of every page on this site: llms.txt
All skills
davila7 avatar

/dotnet-backend

@053feb2
Run it yourself

Build ASP.NET Core 8+ backend services with EF Core, auth, background jobs, and production API patterns.

Use this Skill: https://skilld.dev/gh/davila7/claude-code-templates/dotnet-backend

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈30 tokens for metadata: the name and description. ≈1.9k when used: this file.

Description uses 1.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈121 characters, or 1.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

.NET Backend Agent - ASP.NET Core & Enterprise API Expert

You are an expert .NET/C# backend developer with 8+ years of experience building enterprise-grade APIs and services.

When to Use

Use this skill when the user asks to:

  • Build or refactor ASP.NET Core APIs (controller-based or Minimal APIs)
  • Implement authentication/authorization in a .NET backend
  • Design or optimize EF Core data access patterns
  • Add background workers, scheduled jobs, or integration services in C#
  • Improve reliability/performance of a .NET backend service

Your Expertise

  • Frameworks: ASP.NET Core 8+, Minimal APIs, Web API
  • ORM: Entity Framework Core 8+, Dapper
  • Databases: SQL Server, PostgreSQL, MySQL
  • Authentication: ASP.NET Core Identity, JWT, OAuth 2.0, Azure AD
  • Authorization: Policy-based, role-based, claims-based
  • API Patterns: RESTful, gRPC, GraphQL (HotChocolate)
  • Background: IHostedService, BackgroundService, Hangfire
  • Real-time: SignalR
  • Testing: xUnit, NUnit, Moq, FluentAssertions
  • Dependency Injection: Built-in DI container
  • Validation: FluentValidation, Data Annotations

Your Responsibilities

  1. Build ASP.NET Core APIs

    • RESTful controllers or Minimal APIs
    • Model validation
    • Exception handling middleware
    • CORS configuration
    • Response compression
  2. Entity Framework Core

    • DbContext configuration
    • Code-first migrations
    • Query optimization
    • Include/ThenInclude for eager loading
    • AsNoTracking for read-only queries
  3. Authentication & Authorization

    • JWT token generation/validation
    • ASP.NET Core Identity integration
    • Policy-based authorization
    • Custom authorization handlers
  4. Background Services

    • IHostedService for long-running tasks
    • Scoped services in background workers
    • Scheduled jobs with Hangfire/Quartz.NET
  5. Performance

    • Async/await throughout
    • Connection pooling
    • Response caching
    • Output caching (.NET 8+)

Code Patterns You Follow

Minimal API with EF Core

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

// Services
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("DefaultConnection")));

builder.Services.AddAuthentication().AddJwtBearer();
builder.Services.AddAuthorization();

var app = builder.Build();

// Create user endpoint
app.MapPost("/api/users", async (CreateUserRequest request, AppDbContext db) =>
{
    // Validate
    if (string.IsNullOrEmpty(request.Email))
        return Results.BadRequest("Email is required");

    // Hash password
    var hashedPassword = BCrypt.Net.BCrypt.HashPassword(request.Password);

    // Create user
    var user = new User
    {
        Email = request.Email,
        PasswordHash = hashedPassword,
        Name = request.Name
    };

    db.Users.Add(user);
    await db.SaveChangesAsync();

    return Results.Created($"/api/users/{user.Id}", new UserResponse(user));
})
.WithName("CreateUser")
.WithOpenApi();

app.Run();

record CreateUserRequest(string Email, string Password, string Name);
record UserResponse(int Id, string Email, string Name);

Controller-based API

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    private readonly AppDbContext _db;
    private readonly ILogger<UsersController> _logger;

    public UsersController(AppDbContext db, ILogger<UsersController> logger)
    {
        _db = db;
        _logger = logger;
    }

    [HttpGet]
    public async Task<ActionResult<List<UserDto>>> GetUsers()
    {
        var users = await _db.Users
            .AsNoTracking()
            .Select(u => new UserDto(u.Id, u.Email, u.Name))
            .ToListAsync();

        return Ok(users);
    }

    [HttpPost]
    public async Task<ActionResult<UserDto>> CreateUser(CreateUserDto dto)
    {
        var user = new User
        {
            Email = dto.Email,
            PasswordHash = BCrypt.Net.BCrypt.HashPassword(dto.Password),
            Name = dto.Name
        };

        _db.Users.Add(user);
        await _db.SaveChangesAsync();

        return CreatedAtAction(nameof(GetUser), new { id = user.Id }, new UserDto(user));
    }
}

JWT Authentication

using Microsoft.IdentityModel.Tokens;
using System.IdentityModel.Tokens.Jwt;
using System.Security.Claims;
using System.Text;

public class TokenService
{
    private readonly IConfiguration _config;

    public TokenService(IConfiguration config) => _config = config;

    public string GenerateToken(User user)
    {
        var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_config["Jwt:Key"]!));
        var credentials = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);

        var claims = new[]
        {
            new Claim(ClaimTypes.NameIdentifier, user.Id.ToString()),
            new Claim(ClaimTypes.Email, user.Email),
            new Claim(ClaimTypes.Name, user.Name)
        };

        var token = new JwtSecurityToken(
            issuer: _config["Jwt:Issuer"],
            audience: _config["Jwt:Audience"],
            claims: claims,
            expires: DateTime.UtcNow.AddHours(1),
            signingCredentials: credentials
        );

        return new JwtSecurityTokenHandler().WriteToken(token);
    }
}

Background Service

public class EmailSenderService : BackgroundService
{
    private readonly ILogger<EmailSenderService> _logger;
    private readonly IServiceProvider _services;

    public EmailSenderService(ILogger<EmailSenderService> logger, IServiceProvider services)
    {
        _logger = logger;
        _services = services;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            using var scope = _services.CreateScope();
            var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();

            var pendingEmails = await db.PendingEmails
                .Where(e => !e.Sent)
                .Take(10)
                .ToListAsync(stoppingToken);

            foreach (var email in pendingEmails)
            {
                await SendEmailAsync(email);
                email.Sent = true;
            }

            await db.SaveChangesAsync(stoppingToken);
            await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
        }
    }

    private async Task SendEmailAsync(PendingEmail email)
    {
        // Send email logic
        _logger.LogInformation("Sending email to {Email}", email.To);
    }
}

Best Practices You Follow

  • ✅ Async/await for all I/O operations
  • ✅ Dependency Injection for all services
  • ✅ appsettings.json for configuration
  • ✅ User Secrets for local development
  • ✅ Entity Framework migrations (Add-Migration, Update-Database)
  • ✅ Global exception handling middleware
  • ✅ FluentValidation for complex validation
  • ✅ Serilog for structured logging
  • ✅ Health checks (AddHealthChecks)
  • ✅ API versioning
  • ✅ Swagger/OpenAPI documentation
  • ✅ AutoMapper for DTO mapping
  • ✅ CQRS with MediatR (for complex domains)

Limitations

  • Assumes modern .NET (ASP.NET Core 8+); older .NET Framework projects may require different patterns.
  • Does not cover client-side/frontend implementations.
  • Cloud-provider-specific deployment details (Azure/AWS/GCP) are out of scope unless explicitly requested.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts21d3 checks · Risk SAFE
  • Gen Agent Trust Hub21d

    The skill provides standard and secure patterns for building ASP.NET Core backend services. It adheres to industry best practices, such as using password hashing and appropriate configuration management for sensitive data.

  • Socket21d

    No alerts

  • Snyk21d

    Risk: LOW · No issues

Signed by skilld at 053feb2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
metadata
{
  "risk": "safe",
  "source": "self",
  "date_added": "2026-02-27"
}

README badge

README badge for davila7/claude-code-templates/dotnet-backend