Skip to content

Lombiq/Orchard-Core-Agent-Skills / skills/orchard-core-theming

orchard-core-theming

Verified

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.

FileKindSize
SKILL.mdskill md4.6 KB
references/10-understand-structure/CREATE-THEME.mdmarkdown3.6 KB
references/10-understand-structure/INDEX.mdmarkdown597 B
references/10-understand-structure/LAYOUTS-ZONES.mdmarkdown1.6 KB
references/10-understand-structure/SOLUTION-STRUCTURE.mdmarkdown3.1 KB
references/10-understand-structure/THEME-STRUCTURE.mdmarkdown1.5 KB
references/20-shapes-placement/ALTERNATES.mdmarkdown4.0 KB
references/20-shapes-placement/FORMS-WIDGETS.mdmarkdown3.9 KB
references/20-shapes-placement/INDEX.mdmarkdown1.0 KB
references/20-shapes-placement/MENU-SHAPES.mdmarkdown6.0 KB
references/20-shapes-placement/PAGER-SHAPES.mdmarkdown5.2 KB
references/20-shapes-placement/PLACEMENT.mdmarkdown3.1 KB
references/20-shapes-placement/SHAPE-WORKFLOW.mdmarkdown4.3 KB
references/20-shapes-placement/SHAPES.mdmarkdown1.2 KB
references/30-razor/INDEX.mdmarkdown971 B
references/30-razor/ORCHARD-HELPER.mdmarkdown2.6 KB
references/30-razor/TAG-HELPERS-CACHING.mdmarkdown598 B
references/30-razor/TAG-HELPERS-CONTENT-MENUS.mdmarkdown884 B
references/30-razor/TAG-HELPERS-MEDIA.mdmarkdown1014 B
references/30-razor/TAG-HELPERS-RESOURCES.mdmarkdown1.3 KB
references/30-razor/TAG-HELPERS-SHAPES.mdmarkdown2.6 KB
references/30-razor/TAG-HELPERS-UTILITIES.mdmarkdown1.5 KB
references/30-razor/TAG-HELPERS.mdmarkdown391 B
references/40-liquid/INDEX.mdmarkdown481 B
references/40-liquid/LIQUID-FILTERS.mdmarkdown4.6 KB
references/40-liquid/LIQUID-SHAPES.mdmarkdown1.2 KB
references/40-liquid/LIQUID-TAGS.mdmarkdown4.1 KB
references/40-liquid/LIQUID.mdmarkdown1.2 KB
references/50-content-model/CONTAINERS.mdmarkdown3.1 KB
references/50-content-model/CONTENT-DEFINITIONS-EXAMPLES.mdmarkdown5.5 KB
references/50-content-model/CONTENT-DEFINITIONS-EXTRACTOR.mdmarkdown2.1 KB
references/50-content-model/CONTENT-DEFINITIONS.mdmarkdown4.2 KB
references/50-content-model/CONTENT-ITEMS-EXTRACTOR.mdmarkdown1.9 KB
references/50-content-model/CONTENT-ITEMS.mdmarkdown2.0 KB
references/50-content-model/FIELDS.mdmarkdown6.6 KB
references/50-content-model/INDEX.mdmarkdown1.2 KB
references/50-content-model/PARTS.mdmarkdown3.9 KB
references/50-content-model/SETTINGS.mdmarkdown2.1 KB
references/60-assets-resources/INDEX.mdmarkdown278 B
references/60-assets-resources/RESOURCES.mdmarkdown2.6 KB
references/60-assets-resources/STATIC-FILES.mdmarkdown774 B
references/70-recipes/ADMIN-MENU.mdmarkdown2.7 KB
references/70-recipes/BASE-RECIPES.mdmarkdown2.9 KB
references/70-recipes/FEATURE-CATALOG-ALL.mdmarkdown4.2 KB
references/70-recipes/FEATURE-CATALOG.mdmarkdown1.3 KB
references/70-recipes/ID-GENERATION.mdmarkdown761 B
references/70-recipes/INDEX.mdmarkdown3.4 KB
references/70-recipes/RECIPE-COMMANDS.mdmarkdown886 B
references/70-recipes/RECIPE-CONTENT.mdmarkdown3.2 KB
references/70-recipes/RECIPE-EXAMPLES-CONTENT.mdmarkdown3.6 KB
references/70-recipes/RECIPE-EXAMPLES-SETUP.mdmarkdown5.3 KB
references/70-recipes/RECIPE-EXAMPLES-WORKFLOWS.mdmarkdown8.5 KB
references/70-recipes/RECIPE-EXAMPLES.mdmarkdown262 B
references/70-recipes/RECIPE-STEPS-CONTENT-MEDIA.mdmarkdown1.4 KB
references/70-recipes/RECIPE-STEPS-CORE.mdmarkdown1.4 KB
references/70-recipes/RECIPE-STEPS-DEFINITIONS.mdmarkdown1022 B
references/70-recipes/RECIPE-STEPS-MISC.mdmarkdown1.0 KB
references/70-recipes/RECIPE-STEPS-SEARCH.mdmarkdown1.4 KB
references/70-recipes/RECIPE-STEPS-SECURITY.mdmarkdown840 B
references/70-recipes/RECIPE-STEPS-TEMPLATES-WORKFLOWS.mdmarkdown513 B
references/70-recipes/RECIPE-STEPS.mdmarkdown1.1 KB
references/70-recipes/WORKFLOWS.mdmarkdown12.2 KB
references/80-debugging-discovery/INDEX.mdmarkdown248 B
references/80-debugging-discovery/LOGS.mdmarkdown545 B
references/80-debugging-discovery/SHAPE-TRACE.mdmarkdown1.2 KB
references/90-glossary/GLOSSARY.mdmarkdown2.3 KB
references/90-glossary/INDEX.mdmarkdown164 B
references/TASK-MAP.mdmarkdown3.5 KB
scripts/extract-content-definitions.pyscript16.1 KB
scripts/extract-content-items.pyscript9.2 KB
scripts/generate-orchard-ids.pyscript2.2 KB
scripts/sync-skill.pyscript4.1 KB
---
name: orchard-core-theming
description: 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.
license: MIT
metadata:
  author: Lombiq Technologies
  version: "1.0"
---

# 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.md` and 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.md` only 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.md` to find shape tracing guidance and ask the user if needed.
- Confirm unknown part/field properties in `ContentDefinition.json` (or `OrchardCore.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.md` to find the right recipe references.

## Scripts
Use these scripts instead of hand-building extracts.
- `scripts/extract-content-definitions.py` to extract content types/parts/fields from `ContentDefinition.json` or `OrchardCore.db`, with optional related-type expansion and Markdown/JSON output. See `references/50-content-model/CONTENT-DEFINITIONS-EXTRACTOR.md`.
- `scripts/extract-content-items.py` to get content items from `OrchardCore.db`, filter by type/IDs/text, and optionally emit a recipe `content` step or a Markdown/JSON extract. See `references/50-content-model/CONTENT-ITEMS-EXTRACTOR.md`.
- `scripts/generate-orchard-ids.py` to generate Orchard Core IDs that match the `DefaultIdGenerator` alphabet for stable `ContentItemId` values in recipes. See `references/70-recipes/ID-GENERATION.md`.
- `scripts/sync-skill.py` to 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:
```bash
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.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall