umbraco-add-extension-reference

Add an Umbraco extension project reference to the main .csproj and .sln files.

26|13|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-add-extension-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-add-extension-reference
Source: https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills/tree/main/plugins/umbraco-backoffice-skills/skills/umbraco-add-extension-reference
Command: npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-add-extension-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that newly created or moved Umbraco backoffice extensions are correctly registered within the main Umbraco project and solution, enabling them to load and function properly.

Core Features & Use Cases

  • Project Reference Addition: Automatically adds a <ProjectReference> to the main Umbraco .csproj file.
  • Solution File Integration: Optionally adds the extension to the .sln file for better IDE support.
  • Use Case: After creating a new custom dashboard extension using dotnet new umbraco-extension, this skill will automatically update your main Umbraco project's .csproj and .sln files so the dashboard appears in the backoffice.

Quick Start

Add the new extension located at './MyNewExtension/MyNewExtension.csproj' as a project reference to the main Umbraco instance.

Frequently Asked Questions about umbraco-add-extension-reference

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

FAQPage Schema
How do I add a new Umbraco extension to my main project's .csproj file?

To add an Umbraco extension, this skill automatically inserts a <ProjectReference> into the main Umbraco .csproj file. It dynamically discovers the main project and calculates the correct relative paths for the extension reference.

Why does my custom Umbraco backoffice extension not appear after running dotnet new umbraco-extension?

Your custom Umbraco extension may not appear because it is not registered in the main project. This skill resolves the issue by updating your .csproj and optionally the .sln file so the backoffice extension loads properly.

Can I update the .sln file automatically when adding a project reference to my Umbraco instance?

Yes, you can automatically update the .sln file when adding a project reference. This skill optionally integrates the extension into the solution file, providing better IDE support alongside the .csproj project reference addition.

Does the project reference tool support solutions with multiple .sln files?

Yes, the project reference tool supports solutions with multiple .sln files. It handles dynamic discovery of the main Umbraco project and manages solution file integration even in complex multi-solution scenarios.

How does the extension reference process verify my newly created Umbraco extension exists?

The extension reference process verifies extension existence before adding it to your Umbraco instance. This ensures that only valid extension projects are registered within the .csproj file and solution.

What is the best way to integrate a moved Umbraco backoffice extension into an existing solution?

The best way to integrate a moved Umbraco backoffice extension is to recalculate relative paths and add a project reference. This skill ensures newly moved extensions are correctly registered within the main project and solution files.