Agent skill · Audited from source
convert-blazor-server-to-webapp
skill · dotnet/skillsMIT licenceAudited 13 Nov 2026 · source 75cbe55405f2
Is it safe? Yes — SAFE, grade B (89/100). We read this skill's source at commit 75cbe55405f2 and found no filesystem, network or shell access and no hard-coded secrets. What it does: Guides conversion of a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App. USE FOR: migrating apps that use AddServerSideBlazor and MapBlazorHub to the AddRazorComponents/MapRazorComponents model, converting…
Cite
Cite this page
ModelsAtlas. “convert-blazor-server-to-webapp (dotnet/skills)”. Retrieved 13 Nov 2026. https://modelsatlas.com/skills/dotnet/convert-blazor-server-to-webapp
Trust audit
Audit 0.4.1 · source read 13 Nov 2026
SAFE means nothing in the source contradicts what the skill says it does. Grade B is shared by 17,406 of 18,389 audited skills.
What the source does
- FilesystemNone observedNo reads or writes in the source
- NetworkNone observedNo outbound calls in the source
- ShellNone observedNo commands run in the source
- DependenciesPinnedNothing floats
- SecretsNone foundNo keys in source
Five audit layers
| Layer | What we check | Result | Findings |
|---|---|---|---|
L0 Provenance | Repo owner, licence, archive status, activity | PASS | 0 |
L1 Static source | Secrets, path traversal, supply chain, hidden code | NA | 0 |
L2 Instructions | Prompt injection, authority framing, hidden directives | PASS | 0 |
L3 Inventory | The files and declarations match the source | PASS | 0 |
L4 Sandbox | Run in isolation and watch behaviour | SKIPPED why | 0 |
Gates applied: no behavioural pass.
Findings (0)
No findings at any severity. We re-audit when the source changes.
Audit 0.4.1 · source sha 75cbe55405f2 · 13 Nov 2026Report an issue or request a re-scan
Provenance
Who published it, and what the verdict is pinned to
- Publisherdotnet GitHub organizationOwner of the repository this skill is read from
- Source folderdotnet/skills/plugins/dotnet-aspnetcore/skills/convert-blazor-server-to-webappThe exact folder we audited
- LicenceMITAs the repository states it
- Commit pinned for this verdict75cbe55405f2A new audit runs when the source changes
- Repository statusNot archivedPushed today
- Sandboxed runNot runSkills are read, not executed; layer L4 is skipped
What it tells the agent
Full source on GitHub ↗Its description: Guides conversion of a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App. USE FOR: migrating apps that use AddServerSideBlazor and MapBlazorHub to the AddRazorComponents/MapRazorComponents model, converting…
---
name: convert-blazor-server-to-webapp
license: MIT
description: >
Guides conversion of a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App.
USE FOR: migrating apps that use AddServerSideBlazor and MapBlazorHub to the
AddRazorComponents/MapRazorComponents model, converting _Host.cshtml to an App.razor
root component, replacing blazor.server.js with blazor.web.js, migrating
CascadingAuthenticationState to a service, adopting new Blazor Web App features
like enhanced navigation and streaming rendering.
DO NOT USE FOR: apps that are already Blazor Web Apps (already use AddRazorComponents
and MapRazorComponents), Blazor WebAssembly or hosted Blazor WebAssembly apps
(different migration path), apps that should stay on the Blazor Server hosting
model without converting, or apps still targeting .NET Framework.
---
# Convert Blazor Server App to Blazor Web App
This skill helps an agent convert a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App. The old hosting model uses `AddServerSideBlazor`/`MapBlazorHub` with a `_Host.cshtml` Razor Page as the entry point. The new Blazor Web App model uses `AddRazorComponents`/`MapRazorComponents` with an `App.razor` root component, enabling per-component render modes, enhanced navigation, streaming rendering, and other .NET 8+ features. The converted app uses `InteractiveServer` render mode to preserve existing interactive behavior.
## When to Use
- Migrating a Blazor Server app from .NET 6 or .NET 7 to .NET 8+
- App currently uses `AddServerSideBlazor()` and `MapBlazorHub()` in `Program.cs` (or `Startup.cs`)
- App uses `Pages/_Host.cshtml` (or `_Host.razor`) as the host page with Component Tag Helpers
- Want to adopt new Blazor Web App features while keeping interactive server rendering
## When Not to Use
- **The app already uses `AddRazorComponents` and `MapRazorComponents`.** It is already a Blazor Web App — no conversion is needed. Stop here and tell the user the app is already using the Blazor Web App model.
- Blazor WebAssembly or hosted Blazor WebAssembly app — these have a different migration path
- The app should stay on the legacy Blazor Server hosting model (just update TFM and packages)
- The app targets .NET Framework — it must be migrated to .NET first
## Inputs
| Input | Required | Description |
|-------|----------|-------------|
| Blazor Server project | Yes | The `.csproj` and source files of the Blazor Server app |
| Target framework | Yes | .NET 8 or later (e.g., `net8.0`, `net9.0`, `net10.0`) |
| `Program.cs` or `Startup.cs` | Yes | The app's service and middleware configuration |
| `_Host.cshtml` location | Recommended | Usually `Pages/_Host.cshtml`; may be `_Host.razor` in some projects |
## Workflow
> **Commit strategy:** Commit after each logical step so the migration is reviewable and bisectable.
### Step 1: Update the project file
Update the `.csproj` file:
1. Change the Target Framework Moniker (TFM) to the target version:
```xml
<TargetFramework>net8.0</TargetFramework>
```
2. Update all `Microsoft.AspNetCore.*`, `Microsoft.EntityFrameworkCore.*`, `Microsoft.Extensions.*`, and `System.Net.Http.Json` package references to the matching version.
For non-Blazor project file changes (nullable reference types, implicit usings, HTTP/3 support, etc.), see the [general ASP.NET Core migration guide](https://learn.microsoft.com/aspnet/core/migration/70-to-80).
### Step 2: Create `Routes.razor` from `App.razor`
The old `App.razor` contains the `<Router>` component. This content moves to a new `Routes.razor` file so that `App.razor` can become the root HTML document component.
1. Create a new file `Routes.razor` in the project root.
2. Move the entire content of `App.razor` into `Routes.razor`.
3. If the content is wrapped in `<CascadingAuthenticationState>`, remove that wrapper (it will be replaced by a service in Step 5).
4. Leave `App.razor` empty for the next step.
The resulting `Routes.razor` should look similar to:
```razor
<Router AppAssembly="@typeof(Program).Assembly">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
<FocusOnNavigate RouteData="@routeData" Selector="h1" />
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<p>Sorry, there's nothing at this address.</p>
</LayoutView>
</NotFound>
</Router>
```
If the app uses `<AuthorizeRouteView>` instead of `<RouteView>`, keep it — it works the same way in Blazor Web Apps.
### Step 3: Convert `_Host.cshtml` to `App.razor`
Move the HTML shell from `Pages/_Host.cshtml` into the now-empty `App.razor` and transform it from a Razor Page into a Razor component:
1. **Remove Razor Page directives** — delete `@page "/"`, `@using Microsoft.AspNetCore.Components.Web`, `@namespace`, and `@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers`.
2. **Add component injection** — if using environment-conditional error UI, add:
```razor
@inject IHostEnvironment Env
```
3. **Fix the base tag** — replace `<base href="~/" />` with `<base href="/" />`.
4. **Replace HeadOutlet Component Tag Helper** — replace:
```html
<component type="typeof(HeadOutlet)" render-mode="ServerPrerendered" />
```
with:
```razor
<HeadOutlet @rendermode="InteractiveServer" />
```
5. **Replace App Component Tag Helper with Routes** — replace:
```html
<component type="typeof(App)" render-mode="ServerPrerendered" />
```
with:
```razor
<Routes @rendermode="InteractiveServer" />
```
6. **Replace Environment Tag Helpers** — replace:
```html
<environment include="Staging,Production">
An error has occurred. This application may no longer respond until reloaded.
</environment>
<environment include="Development">
An unhandled exception has occurred. See browser dev tools for details.
</environment>
```
with:
```razor
@if (Env.IsDevelopment())
{
Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.
Install
Pinned to the audited commit 75cbe55
git clone https://github.com/dotnet/skills git -C skills checkout 75cbe55405f2
The author documents no install command, so this uses the repository directly. Our verdict covers commit 75cbe55405f2 only.
Works in
The author has not said which agents this skill supports, and we have not tested it in any.
Audit history
Every audit, every source change
- ✓SAFE B 89 / 100
first audit · source
75cbe55405f2
README badge
For maintainers · shows the latest audit
[](https://modelsatlas.com/skills/dotnet/convert-blazor-server-to-webapp/)
The badge shows our verdict and grade for this skill, and links back to this page. It changes when the audit does.
Similar skills
anthropics/skills
Stop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com),…
anthropics/skills
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.…
anthropics/skills
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design…
anthropics/skills
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual…
anthropics/skills
After you give a substantive answer or draft that the user may act on — advice or recommendations, drafted artifacts such as goals, plans, pitches, proposals, or emails, estimates or projections, analysis or…
anthropics/skills
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users…
Add this badge to your README
[](https://modelsatlas.com/skills/dotnet/convert-blazor-server-to-webapp/)
<a href="https://modelsatlas.com/skills/dotnet/convert-blazor-server-to-webapp/"><img src="https://modelsatlas.com/skills/dotnet/convert-blazor-server-to-webapp/badge.svg" alt="ModelsAtlas: SAFE B"></a>
Questions about convert-blazor-server-to-webapp
What does the convert-blazor-server-to-webapp skill do?
Is convert-blazor-server-to-webapp safe to install?
What can convert-blazor-server-to-webapp access on my machine?
How current is this page?
Sources
- github.com/dotnet/skills/tree/main/plugins/dotnet-aspnetcore/ski — the audited source at commit 75cbe55405f2 and every finding aboveObserved · 13 Nov 2026
Spotted something wrong? Report a correction · Methodology
Keep going in your AI
Opens with this page as the source. We add nothing else to the prompt.
- What does the convert-blazor-server-to-webapp skill do?
- Is convert-blazor-server-to-webapp safe to install?
- What can convert-blazor-server-to-webapp access on my machine?