Lombiq/Orchard-Core-Agent-Skills / skills/orchard-core-theming
orchard-core-theming
VerifiedEvidence-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.
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |