umbraco-add-extension-reference

Add Umbraco extension project references to .csproj and .sln files.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy --skill umbraco-add-extension-reference-kraftvaerk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-add-extension-reference
Source: https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy/tree/main/Kraftvaerk.Umbraco.Alchemy.Frontend/.agents/skills/umbraco-add-extension-reference
Command: npx skills add https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy --skill umbraco-add-extension-reference-kraftvaerk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of adding a new Umbraco backoffice extension project as a reference to the main Umbraco instance and its solution file, ensuring the extension is recognized and loaded correctly.

Core Features & Use Cases

  • Project Referencing: Adds <ProjectReference> entries to the main Umbraco .csproj file.
  • Solution Integration: Optionally adds the extension project to the solution file (.sln) for better IDE support.
  • Use Case: After creating a new custom dashboard or property editor using dotnet new umbraco-extension, use this Skill to quickly integrate it into your existing Umbraco project without manual file editing.

Quick Start

Use the umbraco-add-extension-reference skill to add the extension located at './MyNewExtension/MyNewExtension.csproj' to the main Umbraco project.

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 project to my main CMS solution?

To add an Umbraco extension, you need to insert a `<ProjectReference>` into the main `.csproj` file and optionally register it in the `.sln` solution file. This ensures the backoffice extension is recognized and loaded correctly by the CMS.

What's the best way to integrate a custom Umbraco dashboard created with dotnet new umbraco-extension?

Integrating a custom Umbraco dashboard created with `dotnet new umbraco-extension` requires calculating the relative path from the main project and adding it as a project reference. This avoids manual file editing and ensures proper IDE support.

Why isn't my new Umbraco backoffice extension loading in my existing project?

Your Umbraco extension might not load because the main project is missing the required `<ProjectReference>` entry in its `.csproj` file. The extension project must be properly referenced and optionally added to the `.sln` file to load seamlessly.

Does adding an Umbraco extension update both the csproj and sln files?

Yes, adding an Umbraco extension updates the main `.csproj` file with necessary project references. It can also optionally add the extension project to the `.sln` solution file, providing better IDE support and seamless development integration.

How does dynamic discovery work when referencing Umbraco extension projects?

Dynamic discovery locates the main Umbraco project within your solution, calculates the relative paths to the new extension, and automatically injects the required project references into your `.csproj` file without manual path configuration.

Can I use this to integrate property editors into an existing Umbraco solution?

Yes, you can integrate custom property editors into an existing Umbraco solution. By adding the extension's `.csproj` as a project reference to the main Umbraco instance, the property editor becomes recognized and loaded in the backoffice environment.