OR

orchardcore-theme-creator

A tool to scaffold new OrchardCore themes including manifest files, layouts, and asset management.

Install

mkdir -p .claude/skills/orchardcore-theme-creator && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/6231" && unzip -o skill.zip -d .claude/skills/orchardcore-theme-creator && rm skill.zip

Installs to .claude/skills/orchardcore-theme-creator

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Creates new OrchardCore themes with proper structure, manifest, layouts, and assets. Use when the user needs to create a new theme, customize layouts, or set up frontend assets.
177 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Generate Razor theme layouts
  • Create manifest.cs metadata
  • Configure CSS/JS asset paths
  • Inherit from existing base themes
  • Set up view imports and dependencies

How it works

Generates a standard directory tree and boilerplate Razor files that integrate with the OrchardCore display engine.

Inputs & outputs

You give it
Theme name and base inheritance choice
You get back
Directory structure and base Layout.cshtml

When to use orchardcore-theme-creator

  • Scaffold a new OrchardCore theme
  • Configure theme inheritance from base
  • Set up layout structure for CMS

About this skill

OrchardCore Theme Creator

This skill guides you through creating new OrchardCore themes following project conventions.

Prerequisites

  • OrchardCore repository at D:\orchardcore
  • .NET SDK 10.0+ installed
  • Node.js 22.x and Yarn 4.x (for asset compilation)

Theme Creation Workflow

Step 1: Create Theme Directory

mkdir src/OrchardCore.Themes/YourTheme
cd src/OrchardCore.Themes/YourTheme

Step 2: Create Required Files

Every theme needs these files:

  1. Manifest.cs - Theme metadata
  2. YourTheme.csproj - Project file
  3. Views/Layout.cshtml - Main layout
  4. Views/_ViewImports.cshtml - Razor imports

Step 3: Create Manifest.cs

using OrchardCore.DisplayManagement.Manifest;
using OrchardCore.Modules.Manifest;

[assembly: Theme(
    Name = "Your Theme",
    Author = ManifestConstants.OrchardCoreTeam,
    Website = ManifestConstants.OrchardCoreWebsite,
    Version = ManifestConstants.OrchardCoreVersion,
    Description = "Your theme description."
)]

Extending a base theme:

[assembly: Theme(
    Name = "Your Theme",
    BaseTheme = "TheBlogTheme",  // Inherit from base
    // ... other properties
)]

Step 4: Create Project File

<Project Sdk="Microsoft.NET.Sdk.Razor">
  <PropertyGroup>
    <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
    <Title>Your Theme</Title>
    <Description>Your theme description.</Description>
  </PropertyGroup>

  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
  </ItemGroup>

  <ItemGroup>
    <ProjectReference Include="..\..\OrchardCore\OrchardCore.Theme.Targets\OrchardCore.Theme.Targets.csproj" />
  </ItemGroup>
</Project>

Step 5: Create Layout

Create Views/Layout.cshtml:

<!DOCTYPE html>
<html lang="@Orchard.CultureName()">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>@RenderTitleSegments(Site.SiteName, "before")</title>
    <resources type="StyleSheet" />
</head>
<body>
    <zone Name="Header" />
    <main>
        <zone Name="Messages" />
        <zone Name="Content" />
    </main>
    <zone Name="Footer" />
    <resources type="FootScript" />
</body>
</html>

Step 6: Add Assets (Optional)

Create asset structure:

Assets/
├── scss/site.scss
├── js/site.js
└── package.json
Assets.json

See references/assets.md for configuration details.

Step 7: Build and Activate

# Build theme
cd D:\orchardcore
dotnet build src/OrchardCore.Themes/YourTheme

# Build assets (if added)
yarn && yarn build

# Run application
cd src/OrchardCore.Cms.Web
dotnet run -f net10.0

# Activate theme in Admin → Design → Themes

Quick Reference

Available Zones

ZonePurpose
HeaderSite header
NavigationMain menu
MessagesAlerts/notifications
ContentMain content
SidebarSide widgets
FooterSite footer

Base Themes

ThemeDescription
TheBlogThemeBlog template
TheAdminAdmin UI
TheAgencyThemeBusiness template

Naming Conventions

ItemConvention
Theme folderYourThemeName (PascalCase)
NamespaceYourThemeName
CSS filesite.css
JS filesite.js

References

  • references/theme-structure.md - Directory layout and templates
  • references/assets.md - SCSS, JS, and asset pipeline
  • AGENTS.md (repo root) - Build commands

When not to use it

  • Creating back-end logic modules
  • Directly editing static HTML files
  • When using non-Razor templating engines

Prerequisites

Node.js 22.xYarn 4.xOrchardCore repository

Limitations

  • Theme structure is rigid
  • Requires knowledge of Razor view syntax
  • Asset compilation depends on Node.js availability

How it compares

Standardizes theme inheritance and asset compilation paths specific to OrchardCore design standards.

Compared to similar skills

orchardcore-theme-creator side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
orchardcore-theme-creator (this skill)16moReviewBeginner
avalonia-viewmodels-zafiro06moNo flagsIntermediate
dotnet-blazor03moNo flagsIntermediate
csharp-developer432moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry