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

# Integrate with Readdy Website Builder Skill

> Use natural-language requests to create, update, preview, publish, and manage Readdy websites with your AI agent

Use the Readdy Website Builder Skill with a compatible AI agent, such as OpenClaw, Claude Code, or Codex, to manage your Readdy projects through natural conversation instead of commands.

## Before You Start

Make sure you have:

* A Readdy account.
* An AI agent that supports skills, such as OpenClaw, Claude Code, or Codex.

## Connect the Skill

The same setup flow works with OpenClaw, Claude Code, Codex, and other agents that support skills. You only need to connect your Readdy account once for each agent environment.

<Steps>
  <Step title="Share the Skill with Your Agent">
    Send the ClawHub link to your agent and ask it to install and configure the skill:

    ```text theme={null}
    Install and configure this Readdy Website Builder skill for my Readdy account: https://clawhub.ai/frankready2025/skills/readdy-website-builder
    ```

    If the agent cannot install skills directly, it gives you the one-time installation step to complete.
  </Step>

  <Step title="Get Your Readdy API Key">
    Open the [Readdy API Key page](https://readdy.ai/user/api-key) and sign in with the Readdy account you want to connect. The page displays your current API Key or generates one if you do not have one. Copy the key.

    <Warning>
      Treat your Readdy API Key like a password. Only provide it through the agent's secure credential or configuration flow. Do not include it in a website request, screenshot, source file, or public repository.
    </Warning>
  </Step>

  <Step title="Verify the Connection">
    Ask the agent to connect the API Key and verify access:

    ```text theme={null}
    Connect my Readdy account with this API Key, then list my Readdy projects to verify it works.
    ```

    After the agent confirms the connection, you can use the skill through normal conversation.
  </Step>
</Steps>

## Create a Website

Tell the agent what you want to build. Include the business type, pages, visual direction, language, and important interactions when they matter.

For example:

```text theme={null}
Build a pet store website with a homepage, product categories, featured products, and a contact page. Use a playful visual style and write the content in English.
```

The agent creates the Readdy project and tells you when the website is ready.

<Info>
  Creating a website usually takes around 10 minutes. Keep the conversation open while Readdy generates and builds the project.
</Info>

After it finishes, ask:

```text theme={null}
Show me a preview of the website you just created.
```

## Update an Existing Website

Name the project and describe the change you want:

```text theme={null}
Update my Acme Bakery website. Change the homepage banner to blue, shorten the headline, and add a Shop Now button.
```

You can also refer to the project from the current conversation:

```text theme={null}
Continue working on the website you just created. Add a customer reviews section below the featured products.
```

If more than one project matches your request, the agent asks you to choose the correct one before making changes.

<Info>
  Updating a website usually takes around 10 minutes because Readdy generates and builds a new version.
</Info>

## Preview a Website

Ask for a preview by project name or conversation context:

```text theme={null}
Give me a preview link for the latest version of Acme Bakery.
```

```text theme={null}
Show me the updated website.
```

The agent returns a Readdy preview link that you can open in your browser.

## Publish a Website

Tell the agent which project or approved version you want to publish:

```text theme={null}
Publish the approved version of Acme Bakery.
```

If the project has multiple versions and your choice is unclear, the agent asks you to select one. After publishing succeeds, it returns the live website URL.

## Manage Your Projects

You can ask the agent to manage Readdy projects using natural language.

| What you want to do     | Example request                                               |
| ----------------------- | ------------------------------------------------------------- |
| List projects           | “List my Readdy projects.”                                    |
| View project details    | “Show me the details for Acme Bakery.”                        |
| View available versions | “What versions are available for this project?”               |
| View project history    | “Show me the conversation history for this website.”          |
| Rename a project        | “Rename this project to Acme Bakery.”                         |
| Update business details | “Update the phone number and business hours for Acme Bakery.” |
| Delete a project        | “Delete the old Acme Bakery test project.”                    |

<Warning>
  Deleting a project is permanent. The agent shows you the exact project and asks for confirmation before deleting it.
</Warning>

## Tips

* Mention **Readdy** or **Readdy Website Builder Skill** if the agent does not recognize which skill to use.
* Use the exact project name when you have several projects with similar names.
* Keep each update request focused, then review the preview before requesting another change.
* Clearly identify the approved version before asking the agent to publish.
* Wait for the current create or update request to finish before starting another change on the same project.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The agent does not use the Readdy skill">
    Share the [ClawHub skill link](https://clawhub.ai/frankready2025/skills/readdy-website-builder), ask the agent to verify that the skill is installed, then repeat your request and explicitly say, “Use the Readdy Website Builder Skill.”
  </Accordion>

  <Accordion title="The agent cannot connect to Readdy">
    Sign in to the correct account on the [Readdy API Key page](https://readdy.ai/user/api-key), then ask the agent to reconnect the current API Key and verify access by listing your projects.
  </Accordion>

  <Accordion title="The agent cannot find my project">
    Ask the agent to list your Readdy projects, select the correct project from the results, and repeat your request using its exact name.
  </Accordion>

  <Accordion title="Website generation is taking a long time">
    Creating or updating a website usually takes around 10 minutes. Ask the agent for a status update and keep the current request running.
  </Accordion>

  <Accordion title="The preview link does not open">
    Ask, “Use the Readdy Website Builder Skill to get a new preview link for this project.”
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Which AI agents can I use?">
    You can use OpenClaw, Claude Code, Codex, or another AI agent that supports installing and running skills.
  </Accordion>

  <Accordion title="Do I need to type commands to use the skill?">
    No. After the skill is installed and connected, describe what you want in natural language. The agent uses the appropriate skill action for you.
  </Accordion>

  <Accordion title="Do I need to know my Readdy project ID?">
    No. Refer to the project by name or by the current conversation context. The agent asks you to clarify if multiple projects match.
  </Accordion>

  <Accordion title="Can I continue updating the website in the same conversation?">
    Yes. Review each preview and request another change. The agent continues working with the same Readdy project while the context is clear.
  </Accordion>

  <Accordion title="What should I do if my API Key is exposed?">
    Delete the exposed key from the [Readdy API Key page](https://readdy.ai/user/api-key), create a replacement, and ask the agent to reconnect the skill with the new key.
  </Accordion>
</AccordionGroup>

## Need Help?

If this guide doesn't resolve your issue, [submit a support ticket](https://readdy.ai/feedback). We're here to help!