Updated today
by LeanMeanCleanApps
CleanMinimalApi
A dotnet new template for an ASP.NET Core Minimal API built with a streamlined Clean Architecture on .NET 10.
401 GitHub stars (401)
+1 in 3 days
| Period | New stars |
|---|---|
| Nov 15 | 0 |
| Nov 16 | 0 |
| Nov 17 | +1 |
- 30 skills (30 skills found in its SKILL.md files)
- 62 forks (62 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add LeanMeanCleanApps/CleanMinimalApi
Asks which skills and agents to install. Just one: npx skills add LeanMeanCleanApps/CleanMinimalApi --skill add-a-use-case — add -g for every project.
Claude Code
git clone https://github.com/LeanMeanCleanApps/CleanMinimalApicp -r "CleanMinimalApi/.agents/skills/add-a-use-case" ~/.claude/skills/
Copies the add-a-use-case skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add LeanMeanCleanApps/CleanMinimalApi
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 30 of 39 files.
-
add-a-use-case
How to add a command or query to the Application layer as a vertical slice (request, handler, validator, tests) using source-generated Mediator. Use when adding a new feature, a new query, or a new write operation.
.agents/skills/ on GitHub (opens in a new tab)add-a-use-case/ SKILL.md -
api-conventions
The REST conventions for this API - plural lowercase routes, status codes per operation, problem details for errors, JSON casing and paging parameters. Use when choosing a route, a status code or a response shape.
.agents/skills/ on GitHub (opens in a new tab)api-conventions/ SKILL.md -
branches-and-pull-requests
Branch naming (feature/, fix/, chore/), how labels and release notes follow from the branch, the pull request template, and how changes get merged in the template repository. Use when creating a branch, writing a commit or opening a pull request.
.agents/skills/ on GitHub (opens in a new tab)branches-and-pull-requests/ SKILL.md -
cancellation
How cancellation tokens flow from the caller through Mediator, handlers and repositories to EF Core, and how tests prove they are passed on. Use when writing any async method, endpoint, handler or repository call.
.agents/skills/ on GitHub (opens in a new tab)cancellation/ SKILL.md -
ci-for-your-solution
How CI works in a solution made from this template - the ci.yml that dotnet new ships, the Build Pipeline a "Use this template" copy keeps, and how to add security scans or a container check, or move the pipeline to Azure Pipelines, GitLab or another CI system. Use when CI fails on a fresh solution, when adding a check, or when the engineer asks how to set up CI anywhere other than GitHub Actions.
.agents/skills/ on GitHub (opens in a new tab)ci-for-your-solution/ SKILL.md -
ci-pipeline
The Build Pipeline workflow - its jobs, the six required checks, the Summary comment, the monthly schedules, and how to fix a failing check without weakening it. Use when a check fails, when changing .github/workflows, or when explaining what CI does.
.agents/skills/ on GitHub (opens in a new tab)ci-pipeline/ SKILL.md -
clean-architecture-layers
The dependency rule and what belongs in each layer (Application, Infrastructure, Presentation) of this Clean Architecture solution. Use when deciding where new code goes, adding a project reference, or reviewing a change that crosses layers.
.agents/skills/ on GitHub (opens in a new tab)clean-architecture-layers/ SKILL.md -
configuration-and-environments
How settings are layered with appsettings files and environment variables, what the local and docker environments are, and how to add a new setting. Use when adding configuration, a connection string or environment-specific behaviour.
.agents/skills/ on GitHub (opens in a new tab)configuration-and-environments/ SKILL.md -
coverage
The 95% line coverage gate - what counts, what is excluded and why, and how to measure it locally the same way the pipeline does. Use when coverage fails, when adding code that is hard to test, or before opening a pull request.
.agents/skills/ on GitHub (opens in a new tab)coverage/ SKILL.md -
csharp-house-style
The house C# style enforced by .editorconfig and the build - this. qualification, usings inside file-scoped namespaces, discards, regions, primary constructors, nullable and naming. Use whenever writing or reviewing C# in this solution.
.agents/skills/ on GitHub (opens in a new tab)csharp-house-style/ SKILL.md -
data-access-ef-core
How the repository reads and writes the SQLite database with EF Core - scoped DbContext, no tracking by default, SQL projections for lists, set-based updates and deletes, and safe LIKE searches. Use when adding or changing a repository method or a query.
.agents/skills/ on GitHub (opens in a new tab)data-access-ef-core/ SKILL.md -
database-migrations
How to change the data model and add an EF Core migration for the SQLite database, including the namespace, folder and naming fixes the tools need. Use when adding a column, table, index or relationship.
.agents/skills/ on GitHub (opens in a new tab)database-migrations/ SKILL.md -
docker-and-compose
How the Dockerfile builds, tests and publishes the solution, how the runtime image runs (non-root, /app/data volume, HEALTHCHECK), and what docker-compose starts. Use when changing the Dockerfile, the compose file or how the app runs in a container.
.agents/skills/ on GitHub (opens in a new tab)docker-and-compose/ SKILL.md -
docs-and-voice
Where documentation lives (README, docs/RUN.md, the Lean Mean Clean Apps docs site) and the house voice - professional with a dry sense of humour, Australian spelling, humour in prose but never in steps, commands or tables. Use when writing a README, docs page, release note, issue reply or pull request description.
.agents/skills/ on GitHub (opens in a new tab)docs-and-voice/ SKILL.md -
errors-and-exceptions
How Application reports not found and invalid input with exceptions, and how the presentation layer turns them into responses. Use when a use case can fail, when adding a new error case, or when changing how errors reach the caller.
.agents/skills/ on GitHub (opens in a new tab)errors-and-exceptions/ SKILL.md -
expose-a-use-case
How to put an Application use case on a Minimal API endpoint - endpoint groups, static handler methods, TypedResults, Produces metadata, XML docs for Scalar, JSON source generation and tests. Use when adding or changing an endpoint in this Minimal API.
.agents/skills/ on GitHub (opens in a new tab)expose-a-use-case/ SKILL.md -
family-sync
How a shared change is carried to all five Lean Mean Clean Apps templates - which folders are shared, the namespace swap, opening the same branch everywhere, keeping repository and maintainer skills out of the package, and proving the copies match. Use when you have changed the Application or Infrastructure layers, their tests, shared skills, AGENTS.md, the pipeline or repository setup.
.agents/skills/ on GitHub (opens in a new tab)family-sync/ SKILL.md -
health-checks
How liveness and readiness are reported - the database readiness check from Infrastructure, /health/live and /health/ready, and the Docker HEALTHCHECK. Use when adding a dependency that should affect readiness or changing the health endpoints.
.agents/skills/ on GitHub (opens in a new tab)health-checks/ SKILL.md -
integration-tests
How integration tests run against a real SQLite database - a private in-memory database per repository test, and a per-test application host with its own database for presentation tests. Use when testing the repository, migrations, startup wiring or a real request through the presentation layer.
.agents/skills/ on GitHub (opens in a new tab)integration-tests/ SKILL.md -
json-serialization
How this Minimal API reads and writes JSON with System.Text.Json - the one set of options in UseApiDefaults, the source-generated AppJsonSerializerContext, which types it must list, and how tests use the same options. Use when adding a request or response type, changing how JSON looks, or when a value serialises differently than expected.
.agents/skills/ on GitHub (opens in a new tab)json-serialization/ SKILL.md -
mapping-with-mapperly
How database models map to Application entities with the Mapperly source generator, including ignored members and RMG warnings. Use when adding a property to a model or entity, or adding a new mapping.
.agents/skills/ on GitHub (opens in a new tab)mapping-with-mapperly/ SKILL.md -
mediator
How source-generated Mediator carries requests from the presentation layer to Application handlers - registration and lifetime, IRequest and IRequestHandler, ValueTask, pipeline behaviours and their order, and why it isn't MediatR. Use when adding or changing a pipeline behaviour, sending a request, or when a handler isn't found.
.agents/skills/ on GitHub (opens in a new tab)mediator/ SKILL.md -
openapi-and-scalar
How this Minimal API builds its OpenAPI document and serves the Scalar API reference - AddOpenApi, the document and operation transformers, the bearer scheme when authentication is on, the Scalar options, and the tests that read the generated document. Use when changing the API description, tags, security scheme, Scalar settings, or when the API reference looks wrong.
.agents/skills/ on GitHub (opens in a new tab)openapi-and-scalar/ SKILL.md -
optional-token-auth
How optional JWT bearer authentication works - left out unless the solution was created with --include-auth, every endpoint asks for authorization, the few that stay anonymous, and how to add it later. Use when protecting a new endpoint, making one public, adding authentication to a solution without it, or changing authentication settings.
.agents/skills/ on GitHub (opens in a new tab)optional-token-auth/ SKILL.md -
packages-and-dependencies
How NuGet packages are managed with Central Package Management and a monthly update, and which packages are not allowed. Use when adding, updating or removing a package.
.agents/skills/ on GitHub (opens in a new tab)packages-and-dependencies/ SKILL.md -
paging
Offset paging for every list (offset, limit, totalCount, Page of T), its defaults and limits, and stable ordering. Use when adding or changing anything that returns a list.
.agents/skills/ on GitHub (opens in a new tab)paging/ SKILL.md -
presentation-integration-tests
How this Minimal API is tested end to end with WebApplicationFactory - the MinimalApiApplication host, a private database per test class, overriding settings and services, the JSON helper, asserting problem details, and testing with authentication on and off. Use when writing or fixing a test in tests/Presentation.Tests.Integration.
.agents/skills/ on GitHub (opens in a new tab)presentation-integration-tests/ SKILL.md -
releases
The monthly release of the template - the 1st-of-the-month schedule, the Release Check that skips a month with no changes, the Publish job (SBOM, attestation, NuGet push, GitHub release), version numbers, dry runs and out-of-cycle releases. Use when preparing for a release, rehearsing one, releasing out of cycle, or working out why a release did or didn't happen.
.agents/skills/ on GitHub (opens in a new tab)releases/ SKILL.md -
sample-data
How the sample data is seeded with Bogus behind the Database:SeedSampleData setting, and how tests get their own fixed data. Use when changing seed data, adding a column that needs sample values, or writing tests that depend on known data.
.agents/skills/ on GitHub (opens in a new tab)sample-data/ SKILL.md -
security-findings
How to handle CodeQL, Trivy, Dependency Review and secret scanning findings - fixing them, when a dismissal or .trivyignore entry is acceptable, and who decides. Use when a security check fails or a code scanning alert is raised.
.agents/skills/ on GitHub (opens in a new tab)security-findings/ SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.