caramelo-theme-development

Route Caramelo Theme Child runtime behavior inside WordPress with Astro fallback.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/korflux/skills --skill caramelo-theme-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caramelo-theme-development
Source: https://github.com/korflux/skills/tree/main/skills/caramelo-theme-development
Command: npx skills add https://github.com/korflux/skills --skill caramelo-theme-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline WordPress development for Caramelo Theme Child runtime by providing a clear surface for building, fixing, testing, and reviewing render mode routing, admin workflows, and project-specific customizations while preserving strict boundaries with Caramelo core.

Core Features & Use Cases

  • Route and resolve Caramelo runtime behavior within WordPress, including render mode selection, Astro entry mapping, and release handling.
  • Manage admin surfaces such as Dashboard, Releases, Import, Imported Items, and Logs with documented ownership boundaries.
  • Enforce Caramelo surface ownership and the project customization layer, preventing core code or client snippets from leaking into the runtime.
  • Provide a repeatable decision flow to decide whether changes belong in core Caramelo, a local MU-plugin, or site-specific customizations.

Quick Start

Describe the Caramelo runtime change you want to make, and I will guide you through the correct surface, routing, and admin implications.

Frequently Asked Questions about caramelo-theme-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I route Astro entry mapping and render mode selection in a WordPress theme?

Astro entry mapping and render mode routing in WordPress are managed through the Caramelo runtime, resolving Astro entries while preserving a safe WordPress fallback if Astro resolution fails.

What is the best way to separate project customizations from Caramelo core code?

Separate project customizations from Caramelo core by applying a repeatable decision flow to determine whether changes belong in core, a local MU-plugin, or site-specific customizations, enforcing strict surface ownership boundaries.

How do I manage Caramelo admin surfaces like Releases and Imported Items in WordPress?

Manage Caramelo admin surfaces in WordPress by configuring documented ownership boundaries for Dashboard, Releases, Import, Imported Items, and Logs, ensuring clear separation between theme core and external adaptations.

Why does my WordPress site fall back instead of resolving the Astro entry correctly?

WordPress falls back when Astro resolution fails, which occurs if the runtime cannot properly map the Astro entry, requiring you to check the release and manifest handling configuration.

Can I adjust WordPress routing and release resolution without editing core theme files?

Yes, you can adjust routing and release resolution without editing core files by placing site-specific project customizations in the designated customization layer or a local MU-plugin, preserving the Caramelo contract.