Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

npx skills add dotnet/skills --skill convert-blazor-server-to-webapp -a cursor -y

Download skill

plugins/dotnet-aspnetcore/skills/convert-blazor-server-to-webapp/SKILL.md on GitHub

Questions

How do I install convert-blazor-server-to-webapp?

Download plugins/dotnet-aspnetcore/skills/convert-blazor-server-to-webapp/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.

Where does convert-blazor-server-to-webapp live?

The publisher keeps it at https://github.com/dotnet/skills.

Which agents can use convert-blazor-server-to-webapp?

Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

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 / with a Razor Page as the entry point. The new Blazor Web App model uses / with an root component, enabling per-component render modes, enhanced navigation, streaming rendering, and other .NET 8+ features. The converted app uses render mode to preserve existing interactive behavior.

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

Pitfall	Solution
Missing `UseAntiforgery()` middleware	`AddRazorComponents` registers antiforgery services, but the middleware must be explicitly added. Place `app.UseAntiforgery()` after `UseAuthentication`/`UseAuthorization`. Without it, form POST requests fail with 400 errors.
Forgetting to replace `blazor.server.js` with `blazor.web.js`	The old script does not work with the Blazor Web App model. Replace all references to `_framework/blazor.server.js` with `_framework/blazor.web.js`.
Not removing `<CascadingAuthenticationState>` wrapper	The component wrapper does not work across render mode boundaries in Blazor Web Apps. Use `builder.Services.AddCascadingAuthenticationState()` instead.
Leaving `app.UseRouting()` in the pipeline	Explicit `UseRouting()` is no longer needed and can interfere with endpoint routing. Remove it unless other middleware specifically requires it.
Using `InteractiveServer` when prerendering was disabled	If the original app used `render-mode="Server"` (not `"ServerPrerendered"`), use `new InteractiveServerRenderMode(prerender: false)` to preserve the same behavior. Using `InteractiveServer` enables prerendering which can cause unexpected issues with components that depend on JS interop during initialization.
Not migrating `AddServerSideBlazor` circuit options	If circuit options, hub options, or detailed error settings were configured, migrate them to `AddInteractiveServerComponents(options => { ... })`. Otherwise those settings are silently lost.
`UseAntiforgery()` placed before authentication middleware	The antiforgery middleware must be placed after `UseAuthentication` and `UseAuthorization`. Placing it before causes antiforgery validation to run before the user identity is established.
CSS isolation bundle link has wrong assembly name	If the `<link href="{Name}.styles.css">` tag referenced the old project name, update it to match the current assembly name.

convert-blazor-server-to-webapp

Install

Related skills

Questions

Convert Blazor Server App to Blazor Web App

When to Use

When Not to Use

Inputs

Workflow

Step 1: Update the project file

Step 2: Create `Routes.razor` from `App.razor`

Step 3: Convert `_Host.cshtml` to `App.razor`

Step 4: Update `Program.cs`

Step 5: Migrate `CascadingAuthenticationState` (if present)

Step 6: Recommended improvements (optional)

Step 7: Verify the migration

Validation

Common Pitfalls

More Info

Install

Related skills

Questions

Convert Blazor Server App to Blazor Web App

When to Use

When Not to Use

Inputs

Workflow

Step 1: Update the project file

Step 2: Create Routes.razor from App.razor

Step 3: Convert _Host.cshtml to App.razor

Step 4: Update Program.cs

Step 5: Migrate CascadingAuthenticationState (if present)

Step 6: Recommended improvements (optional)

Step 7: Verify the migration

Validation

Common Pitfalls

More Info

Step 2: Create `Routes.razor` from `App.razor`

Step 3: Convert `_Host.cshtml` to `App.razor`

Step 4: Update `Program.cs`

Step 5: Migrate `CascadingAuthenticationState` (if present)