Individual skill

orchardcore-custom-settings

Skill for creating admin-defined custom site settings in Orchard Core using the CustomSettings stereotype. Covers settings content types in code or recipes, the per-section ManageCustomSettings permission, GetCustomSettingsAsync, Liquid access through Site.Properties and the PermittedSiteProperties allow list, rendering stored HTML safely with sanitize_html, the custom-settings recipe step, the Custom Settings deployment step, and when to use a code-defined SiteDisplayDriver instead. Use this skill when requests mention Orchard Core Custom Settings, Create Custom Site Settings, Accessing Custom Settings in Code or Liquid, Site.Properties is empty, or closely related Orchard Core implementation, upgrade, or troubleshooting work. Strong matches include OrchardCore.CustomSettings, CustomSettings stereotype, ISiteService, GetCustomSettingsAsync, ContentPart, DataMigration, IContentDefinitionManager, SettingsLiquidOptions, PermittedSiteProperties.

src/CrestApps.AgentSkills/orchardcore/orchardcore-custom-settings/SKILL.md

Read pinned source

Source commit d86d04f234b1b2bd8145368a2544490f9d557596

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Instructions only
Last checked: Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 13
Repository last updated: Oct 21, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

agent-skills Repository topic
ai Repository topic
ai-agents-framework Repository topic
dotnet Repository topic
mcp Repository topic
mcp-server Repository topic
orchardcore Repository topic
writing Derived category
devops Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 12,266 bytes

Read excerpt


# Orchard Core Custom Settings - Prompt Templates

## Create Custom Site Settings

You are an Orchard Core expert. Generate code and configuration for creating site-wide settings sections using the `CustomSettings` stereotype.

### Guidelines

- Enable the `OrchardCore.CustomSettings` feature to use custom site settings.
- Each custom settings section is a content type with the `CustomSettings` stereotype, made of parts and fields like any other content type.
- For this stereotype the type editor hides the `Creatable`, `Listable`, `Draftable`, and `Versionable` options; also leave `Securable` off, since each section gets its own permission.
- Do **not** mark an existing content type with the `CustomSettings` stereotype; this breaks existing content items of that type.
- Sections appear under **Settings** in the admin, next to module-provided settings.
- Each section gets a `ManageCustomSettings_{TypeName}` permission under the `OrchardCore.CustomSettings` group of the Roles editor; it has no default role stereotype.