caramelo-astro-adaptation

Adapt Astro builds into Caramelo-ready WordPress releases with manifest generation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams adapt an Astro site or build so it can be published through Caramelo Theme Child, ensuring a Caramelo-compatible release with manifest generation, page-to-entry mapping, and proper asset handling.

Core Features & Use Cases

  • Produces a Caramelo-ready static release from an Astro build, including manifest.json, HTML entry mapping, and _astro assets.
  • Enforces release contract boundaries, asset strategy, and clean separation between Astro source-project changes and WordPress-runtime changes.
  • Use Case: Map public URLs to manifest entries like index and campanha/verao and package a ZIP release for Caramelo import.

Quick Start

Identify the Astro source project to publish and run the adaptation workflow to generate the Caramelo-ready manifest and release package.

Frequently Asked Questions about caramelo-astro-adaptation

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

FAQPage Schema
How do I adapt an Astro static build for WordPress release packaging?

Adapt an Astro static build for WordPress release packaging by generating a Caramelo-ready release with manifest.json, HTML entry mapping, and proper _astro asset handling. This enforces Caramelo's strict release contract boundaries while avoiding SSR or runtime dependencies inside WordPress.

What is manifest.json entry mapping when converting Astro sites to WordPress?

Manifest.json entry mapping when converting Astro sites to WordPress is the process of linking public URLs like index or campanha/verao to specific HTML entries. This creates a structured manifest that Caramelo uses to route and serve the adapted static build correctly.

Can I use server-side rendering with Astro builds for Caramelo WordPress releases?

No, you cannot use server-side rendering with Astro builds for Caramelo WordPress releases. The adaptation enforces strict static build boundaries and avoids SSR or runtime dependencies inside WordPress, ensuring only static assets and HTML entries are packaged.

How do I package an Astro site into a ZIP release for Caramelo import?

Package an Astro site into a ZIP release for Caramelo import by running the adaptation workflow on your Astro source project. This generates the required manifest.json, applies page-to-entry URL mapping, and bundles the _astro assets into a Caramelo-ready release package.

What's the best way to handle _astro assets when adapting Astro builds for Caramelo?

The best way to handle _astro assets when adapting Astro builds for Caramelo is to enforce a clean asset strategy that maintains strict separation between Astro source-project changes and WordPress-runtime changes. This ensures assets are correctly packaged and mapped in the release.