orchardcore-recipes

name: orchardcore-recipes description: Skill for creating Orchard Core recipes. Covers recipe structure, content type definitions, content items, feature enablement, and recipe steps. Use this skill when requests mention Orchard Core Recipes, Create a Recipe, Required Reference Workflow, Recipe Schema References, Recipe Structure, Common Recipe Steps, or closely related Orchard Core implementation, setup, extension, or troubleshooting work. Strong matches include work with OrchardCore.ContentManagement, OrchardCore.ContentTypes, OrchardCore.Title, OrchardCore.Autoroute, ContentDefinition, ContentTypeSettings, TitlePart, .schema.json, schema.json. It also helps with Recipe Structure, Common Recipe Steps, plus the code patterns, admin flows, recipe steps, and referenced examples captured in this skill. license: Apache-2.0 metadata: author: CrestApps Team version: "1.0"

Orchard Core Recipes - Prompt Templates

Create a Recipe

You are an Orchard Core expert. Generate a recipe JSON file for configuring an Orchard Core site.

Guidelines

• Recipes are JSON files with a specific structure containing steps.
• Each step has a name property that determines its type.
• Steps are executed in order during recipe execution.
• Use Feature step to enable features before configuring them.
• Use ContentDefinition step to define content types and parts.
• Use Content step to create content items.
• Recipe files are placed in the module's Recipes folder.
• For recipe-generated content items, do not hard-code manually invented ContentItemId or ContentItemVersionId values.
• Prefer recipe variables and JavaScript expressions such as [js: uuid()], [js: new Date().toISOString()], and variables('name') when you need reusable ids, timestamps, concatenation, or other computed values.
• Treat references/recipe-schemas/recipe.schema.json as the authoritative schema for the full recipe document.
• Before writing any step payload, open references/recipe-schemas/index.json, find the exact step file, and use that <step>.schema.json as the authoritative contract for allowed properties, required properties, casing, and enum values.
• Do not invent step names, property names, or alternate casing. Copy the exact name value required by the step schema.
• When using ContentDefinition, also consult the orchardcore-content-fields and orchardcore-content-parts skills for valid field settings, editors, display modes, and part-specific options, then make sure the final JSON still conforms to references/recipe-schemas/ContentDefinition.schema.json.
• If a step schema and an example conflict, follow the schema.

Required Reference Workflow

1. Start with references/recipe-schemas/recipe.schema.json to shape the root recipe object.
2. Open references/recipe-schemas/index.json to locate the per-step schema file for every step you plan to emit.
3. Validate each step against its own .schema.json file before returning the final recipe.
4. For ContentDefinition recipes, combine the schema with the specialized content-field and content-part skills instead of guessing field editors or settings.

Recipe Schema References

• references/recipe-schemas/recipe.schema.json — full recipe schema with the steps array.
• references/recipe-schemas/index.json — map of recipe step names to per-step schema files.
• references/recipe-schemas/*.schema.json — one file per supported recipe step.
• references/recipe-schemas/README.md — guidance on how to use the generated schema files with this skill.

Recipe Structure

{
  "name": "{{RecipeName}}",
  "displayName": "{{DisplayName}}",
  "description": "{{Description}}",
  "author": "{{Author}}",
  "website": "{{Website}}",
  "version": "1.0.0",
  "issetuprecipe": false,
  "categories": ["{{Category}}"],
  "tags": [],
  "steps": []
}

This structure is illustrative. The generated schema files in references/recipe-schemas/ are the source of truth.

Common Recipe Steps

Feature Step

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.ContentManagement",
        "OrchardCore.ContentTypes",
        "OrchardCore.Title",
        "OrchardCore.Autoroute"
      ],
      "disable": []
    }
  ]
}

Use references/recipe-schemas/feature.schema.json for the exact schema, especially the valid feature IDs and property casing.

Content Definition Step

{
  "steps": [
    {
      "name": "ContentDefinition",
      "ContentTypes": [
        {
          "Name": "{{ContentTypeName}}",
          "DisplayName": "{{DisplayName}}",
          "Settings": {
            "ContentTypeSettings": {
              "Creatable": true,
              "Listable": true,
              "Draftable": true,
              "Versionable": true
            }
          },
          "ContentTypePartDefinitionRecords": [
            {
              "PartName": "TitlePart",
              "Name": "TitlePart",
              "Settings": {}
            }
          ]
        }
      ],
      "ContentParts": []
    }
  ]
}

Use references/recipe-schemas/ContentDefinition.schema.json for the step wrapper and content-definition structure, then consult orchardcore-content-fields and orchardcore-content-parts for field- and part-specific option catalogs.

Content Step

{
  "variables": {
    "now": "[js: new Date().toISOString()]",
    "year": "[js: new Date().getFullYear()]",
    "featuredCategoryId": "[js: uuid()]"
  },
  "steps": [
    {
      "name": "Content",
      "data": [
        {
          "ContentItemId": "[js: uuid()]",
          "ContentItemVersionId": "[js: uuid()]",
          "ContentType": "{{ContentTypeName}}",
          "DisplayText": "[js: 'Spring of ' + variables('year')]",
          "Latest": true,
          "Published": true,
          "ModifiedUtc": "[js: variables('now')]",
          "PublishedUtc": "[js: variables('now')]",
          "CreatedUtc": "[js: variables('now')]",
          "TitlePart": {
            "Title": "[js: 'Spring of ' + variables('year')]"
          }
        },
        {
          "ContentItemId": "[js: variables('featuredCategoryId')]",
          "ContentItemVersionId": "[js: uuid()]",
          "ContentType": "{{ContentTypeName}}",
          "DisplayText": "Summer Program",
          "Latest": true,
          "Published": true,
          "ModifiedUtc": "[js: variables('now')]",
          "PublishedUtc": "[js: variables('now')]",
          "CreatedUtc": "[js: variables('now')]",
          "TitlePart": {
            "Title": "Summer Program"
          }
        }
      ]
    }
  ]
}

Use references/recipe-schemas/content.schema.json for the exact step contract.