Orchard core theming
Skill Lombiq/Orchard-Core-Agent-Skills/skills/orchard-core-theming
Reusable, agent-agnostic knowledge packs for Orchard Core development, focused on theming, shapes, content modeling, and evidence-first workflows.
npx -y skills add Lombiq/Orchard-Core-Agent-Skills --skill orchard-core-themingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Evidence-first Orchard Core theming skill for shapes, alternates, placement, Razor/Liquid templates, content model access, assets/resources, and recipes. Use for theme adjustments, shape overrides, template discovery, content item/field access, placement.json rules, and recipe authoring in Orchard Core projects.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.6 KB, as published. Nobody here has run it
Orchard Core Theming
Use this skill for Orchard Core theming and content-definition/recipe work.
How to use
- Path A (task match): scan the Tasks list; if the request matches, open
references/TASK-MAP.mdand go directly to the leaf files. - Path B (exploration): use the section cues to pick a reference section, open that section's
INDEX.md, then choose the leaf file it points to. - Determine Razor vs Liquid early using the workflow in
references/TASK-MAP.md. If it cannot be decided, fall back to Liquid and confirm with the user. - Open only the necessary leaf files; use a section
INDEX.mdonly for orientation and discovery. - Prefer examples and ready-to-copy patterns.
Evidence rules
- Prefer repo evidence over assumptions: active theme, base theme,
placement.json, and existing templates. - Trace the shape model first when it is unclear; use
references/TASK-MAP.mdto find shape tracing guidance and ask the user if needed. - Confirm unknown part/field properties in
ContentDefinition.json(orOrchardCore.db) and the relevant field references. - Ask for missing identifiers (content type, part name, field name, display type) instead of inventing them.
- Do not invent recipe steps or feature IDs; use
references/TASK-MAP.mdto find the right recipe references.
Scripts
Use these scripts instead of hand-building extracts.
scripts/extract-content-definitions.pyto extract content types/parts/fields fromContentDefinition.jsonorOrchardCore.db, with optional related-type expansion and Markdown/JSON output. Seereferences/50-content-model/CONTENT-DEFINITIONS-EXTRACTOR.md.scripts/extract-content-items.pyto get content items fromOrchardCore.db, filter by type/IDs/text, and optionally emit a recipecontentstep or a Markdown/JSON extract. Seereferences/50-content-model/CONTENT-ITEMS-EXTRACTOR.md.scripts/generate-orchard-ids.pyto generate Orchard Core IDs that match theDefaultIdGeneratoralphabet for stableContentItemIdvalues in recipes. Seereferences/70-recipes/ID-GENERATION.md.scripts/sync-skill.pyto refresh the entire skill folder from the Lombiq/Orchard-Core-Agent-Skills repo (references, scripts, SKILL.md, assets). The running script is not overwritten until the next sync.
Sync example:
python skills/orchard-core-theming/scripts/sync-skill.py
Reference section cues
Use these cues to decide which reference section to open.
- Use
references/10-understand-structure/to confirm solution and theme structure (manifests, base theme), create themes, and locate layouts/zones. - Use
references/20-shapes-placement/to find shape names, alternates, placement rules, and override workflow steps. - Use
references/30-razor/to implement Razor theme changes with tag helpers, shape rendering, and IOrchardHelper. - Use
references/40-liquid/to implement Liquid theme changes with tags, filters, and shape helpers. - Use
references/50-content-model/to inspect content definitions/items, parts/fields, settings/containers, and the extractors. - Use
references/60-assets-resources/to include scripts/styles and manage resources and static files. - Use
references/70-recipes/to author, validate, and reuse recipes for setup, definitions, and content import. - Use
references/80-debugging-discovery/to trace shapes, inspect logs, and find evidence in source. - Use
references/90-glossary/to resolve terms and acronyms in Orchard Core theming docs.
Tasks
Use this list to decide whether to open references/TASK-MAP.md for the exact leaf files.
- Determine template language (Razor vs Liquid).
- Add or update a content type/part/field in ContentDefinition.json.
- Extract a focused content definition slice (large JSON).
- Create a setup recipe.
- Add content types and sample content to a recipe.
- Create or update workflows in a recipe.
- Create or override a content item shape template.
- Implement or override OrchardCore.Forms widgets and Form content.
- Inspect real content items (SQLite).
- Update a shape after adding fields.
- Render BagPart/FlowPart/ListPart items.
- Add scripts/styles and include them in the layout.
- Find shape alternates and placement rules.
- Find evidence in Orchard Core source.
- Work on theme structure or layout.
- Understand solution structure.