renderkit

# RenderKit Skill

Render structured data as beautiful hosted web pages, and create hosted forms for data collection.

## Setup

1. Sign up at [https://renderkit.live](https://renderkit.live) to get your API key
2. Set your environment variable:

```bash
export RENDERKIT_API_KEY="your-api-key"
```

## Usage

All commands use curl to hit the RenderKit API. Pick the right endpoint:

- **Read-only pages** (results, summaries, comparisons, itineraries) → `POST /v1/render`
- **Data collection** (forms, surveys, RSVPs, signups, feedback) → `POST /v1/forms`

### Create a page

```bash
curl -s -X POST https://renderkit.live/v1/render \
  -H "Authorization: Bearer $RENDERKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "freeform",
    "context": "brief description of what this content is",
    "data": {
      "title": "Page Title",
      "content": "your data here — markdown, structured objects, anything"
    }
  }'
```

Returns `url`, `slug`, and `render_id`. Templates: `freeform` (AI picks layout) or `travel_itinerary`.

### Update a page

```bash
curl -s -X PATCH https://renderkit.live/v1/render/{render_id} \
  -H "Authorization: Bearer $RENDERKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "strategy": "merge",
    "context": "updated description",
    "data": { "content": "new or additional data" }
  }'
```

Strategies: `merge` (add sections) or `replace` (full rewrite). The URL stays the same.

### Check page status

```bash
curl -s https://renderkit.live/v1/render/{render_id}/status \
  -H "Authorization: Bearer $RENDERKIT_API_KEY"
```

### Create a form

```bash
curl -s -X POST https://renderkit.live/v1/forms \
  -H "Authorization: Bearer $RENDERKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Event RSVP",
    "prompt": "Create an RSVP form for a dinner party. Ask for name, email, dietary restrictions, and plus-one.",
    "multi_response": true,
    "expires_in": 604800
  }'
```

Returns a `u...