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.