> ## Documentation Index
> Fetch the complete documentation index at: https://opencals.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agents & App Builders

> Agent Skills that teach AI coding tools — Claude Code, Cursor, Codex, Gemini CLI — to build booking integrations on the Opencals API correctly. Install once and let your agent scaffold, wire, and debug.

Most Opencals integrations are now written inside an AI coding agent. **Agent
Skills** give that agent ground-truth knowledge of the Opencals API and SDK — the
real method names, argument shapes, and flows — so it builds working code instead
of guessing.

Skills follow the open [Agent Skills](https://code.claude.com/docs/en/skills)
standard (a folder with a `SKILL.md`), supported by Claude Code, Cursor, OpenAI
Codex, Gemini CLI and more. They live in one public repo:
**[github.com/letsopencals/skills](https://github.com/letsopencals/skills)**.

## The two skills

<CardGroup cols={2}>
  <Card title="opencals-storefront-api" icon="code">
    Ground truth for any code that talks to the Opencals API / SDK — availability,
    carts, appointments, checkout, discounts, customer accounts, guests &
    attendees, custom durations, reschedule/cancel, rate limits.
    [Details →](/docs/ai-agents/storefront-api-skill)
  </Card>

  <Card title="opencals-build-booking-site" icon="layout-template">
    Build a whole booking website — pick an official template, scaffold, wire it
    up, rebrand, deploy. Uses the API skill for exact call shapes.
    [Details →](/docs/ai-agents/build-booking-site-skill)
  </Card>
</CardGroup>

## The primary journey

<Steps>
  <Step title="Describe your business">
    Hand your agent a business idea and some inspiration — screenshots, a
    competitor site, a brand feel.
  </Step>

  <Step title="The agent builds it">
    `opencals-build-booking-site` picks the closest template and scaffolds it;
    `opencals-storefront-api` supplies the exact API calls to wire availability,
    booking and checkout.
  </Step>

  <Step title="Rebrand & deploy">
    The agent restyles to your inspiration and deploys to Vercel. You add your
    Opencals API key. Bookings, checkout and payments work out of the box.
  </Step>
</Steps>

## Install

<Tabs>
  <Tab title="Claude Code">
    ```
    /plugin marketplace add letsopencals/skills
    /plugin install opencals@opencals
    ```

    Both skills load automatically and trigger on relevant requests.
  </Tab>

  <Tab title="Cursor / Codex / Gemini">
    Agent Skills are portable — a folder with a `SKILL.md`. Clone the repo and
    copy the skill folders into your tool's skills directory:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
    git clone https://github.com/letsopencals/skills opencals-skills
    # copy opencals-storefront-api/ and opencals-build-booking-site/
    # into your agent's skills folder
    ```

    <Note>The exact skills directory differs per tool — check your tool's current Agent Skills / rules docs for where skill folders go.</Note>
  </Tab>

  <Tab title="Any agent (manual)">
    Clone the repo and point your agent at the relevant `SKILL.md`:

    > Follow the skill in `opencals-storefront-api/SKILL.md` when writing Opencals
    > API code, and `opencals-build-booking-site/SKILL.md` to scaffold a site.
  </Tab>

  <Tab title="v0 / Lovable / Base44">
    Each AI app builder has its own setup, with every field ready to copy:

    * **[Lovable](/docs/ai-agents/lovable)**: a custom connector with two knowledge files.
    * **[v0](/docs/ai-agents/v0)**: attach these skills from skills.sh (`letsopencals/skills`).
    * **[Base44](/docs/ai-agents/base44)**: one backend function, an app secret and two workspace skills.

    For other builders (Bolt, Replit), paste the
    [API reference](https://opencals.com/ai/opencals-storefront-api.md) and
    [booking-site playbook](https://opencals.com/ai/lovable-booking-site-playbook.md)
    into the project instructions.
  </Tab>
</Tabs>

## AI app builders

<CardGroup cols={3}>
  <Card title="Lovable" icon="heart" href="/docs/ai-agents/lovable">Custom connector + knowledge files</Card>
  <Card title="v0" icon="triangle" href="/docs/ai-agents/v0">Opencals skills from skills.sh</Card>
  <Card title="Base44" icon="box" href="/docs/ai-agents/base44">Backend function + workspace skills</Card>
</CardGroup>

## For AI agents reading this

The full documentation is available as machine-readable Markdown:

<CardGroup cols={2}>
  <Card title="llms.txt" icon="file-text" href="https://opencals.com/docs/llms.txt">
    Structured index of every docs page.
  </Card>

  <Card title="llms-full.txt" icon="file-text" href="https://opencals.com/docs/llms-full.txt">
    The complete docs in one file for maximum context.
  </Card>
</CardGroup>

The [API reference](/docs/api-reference/introduction) is generated from the OpenAPI
spec — download it via the **Download spec** action, or fetch
[openapi.json](/docs/api-reference/openapi.json) directly.