Embeds
DevelopmentembedsEmbeds is an Agent Skill for development published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Inline, popup, and floating-button embeds — snippet generation and theming.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/packages/scheduling/docs/skills/embeds/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/embeds, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Embeds
Modes
- inline — iframe embedded in the page
- popup — trigger opens modal overlay with iframe
- element-click / floating-button — fixed-position trigger anywhere on the page
URL
Embed page: /:user/:slug/embed — same Booker, no chrome, theme honored
via query params.
Snippet
<script src="https://<host>/embed.js" async></script>
<div id="cal-inline-embed"></div>
<script>
Cal("init", { origin: "https://<host>" });
Cal("inline", {
elementOrSelector: "#cal-inline-embed",
calLink: "my-user/intro",
config: { theme: "light" }
});
</script>
Theming
Query params on the embed URL:
theme=light|darkprimaryColor=<hex>locale=en|es|...timeZone=America/Los_Angeles
These override the event type's defaults for the embedded session only.
Message passing
The iframe posts messages to the parent on lifecycle events:
__cal.init, __cal.booking-successful, __cal.booking-cancelled,
__cal.booking-rescheduled.