umbraco-razor-navigation-cleanup

Refactor Umbraco Razor templates to type-safe navigation and async partial rendering.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill umbraco-razor-navigation-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-razor-navigation-cleanup
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/umbraco-razor-navigation-cleanup
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill umbraco-razor-navigation-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses technical debt in Umbraco v17 projects by identifying and replacing deprecated IPublishedContent navigation properties and resolving MVC analyzer warnings related to synchronous partial rendering.

Core Features & Use Cases

  • Navigation Refactoring: Automatically updates deprecated Children and Parent properties to modern, type-safe alternatives like Children<T>() and Parent<T>().
  • Rendering Optimization: Converts legacy synchronous Html.Partial calls to asynchronous Html.PartialAsync to improve performance and compliance with modern MVC standards.
  • Use Case: When upgrading an Umbraco site to v17, use this skill to scan your Razor views and ensure all navigation logic and partial view rendering follow the latest framework best practices.

Quick Start

Use the umbraco-razor-navigation-cleanup skill to refactor all deprecated navigation properties and partial rendering calls in the current project directory.

Frequently Asked Questions about umbraco-razor-navigation-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix deprecated IPublishedContent navigation properties in Umbraco v17?

To fix deprecated IPublishedContent navigation properties in Umbraco v17, you must refactor legacy Razor templates by replacing Children and Parent properties with type-safe alternatives like Children<T>() and Parent<T>() to ensure compliance with modern Published Model standards.

Why does Umbraco show MVC analyzer warnings for synchronous partial rendering?

Umbraco shows MVC analyzer warnings for synchronous partial rendering because legacy Html.Partial calls do not comply with modern MVC performance standards. Upgrading these calls to asynchronous Html.PartialAsync patterns resolves the warnings and improves template rendering performance.

Can I use this Razor refactoring approach for an Umbraco v17 migration project?

Yes, you can use this refactoring approach for an Umbraco v17 migration project. It specifically targets technical debt by scanning Razor views to ensure navigation logic and partial rendering follow the latest framework best practices required for the v17 upgrade.

What is the best way to modernize Umbraco Razor views for type safety?

The best way to modernize Umbraco Razor views for type safety is replacing deprecated IPublishedContent navigation properties with generic, type-safe alternatives. This refactoring ensures templates adhere to current Umbraco API patterns and eliminates legacy dynamic property access.

Does replacing legacy navigation properties in Umbraco Razor require manual updates to every view?

Replacing legacy navigation properties in Umbraco Razor does not require manual updates to every view. The refactoring process scans the current project directory to automatically identify and update deprecated properties and synchronous partial rendering calls across the templates.