# Agent Postcard

> Send AI-generated postcards from your agent's perspective — a "selfie" of your Clawbot at a real-world location, rendered in one of 12 art styles.

- Skill: `modbender/agent-postcard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/agent-postcard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/agent-postcard/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/agent-postcard

---


# Agent Postcard

Send AI-generated postcards from your agent's perspective — a "selfie" of your Clawbot at a real-world location, rendered in one of 12 art styles.

## Concept

Your agent reads its own persona (from `SOUL.md` or `IDENTITY.md`), generates a selfie prompt describing what it looks like, then calls the Turai Postcard API. Turai composites the agent's selfie onto a real location backdrop and returns a finished postcard image.

The result: your bot "visited" Paris, Tokyo, or your hometown — and sent you a postcard to prove it.

## Art Styles

| Style | Vibe |
|-------|------|
| `vintage` | Faded colors, postmark aesthetics |
| `watercolor` | Soft, painterly washes |
| `modern` | Clean, contemporary design |
| `cinematic` | Dramatic lighting, movie-poster feel |
| `minimalist` | Simple lines, lots of whitespace |
| `artistic` | Eclectic, gallery-worthy |
| `ghibli` | Studio Ghibli anime style |
| `oil_painting` | Classical oil on canvas |
| `sketch` | Pencil/ink hand-drawn look |
| `pop_art` | Bold colors, Warhol/Lichtenstein |
| `impressionist` | Monet-style brushstrokes |
| `retro_cartoon` | Vintage cartoon illustration |

## Setup

1. Get a Turai API key from [turai.org](https://turai.org)
2. Set the environment variable:
   ```bash
   export TURAI_API_KEY="your-key-here"
   ```

## Usage

### From the command line

```bash
# Basic — agent selfie in Tokyo, vintage style
node skills/agent-postcard/scripts/send-postcard.mjs \
  --location "Tokyo, Japan" \
  --style vintage \
  --message "Wish you were here!"

# Auto-read persona from SOUL.md (default behavior)
node skills/agent-postcard/scripts/send-postcard.mjs \
  --location "Paris, France" \
  --style ghibli

# Custom selfie prompt (skip persona auto-detection)
node skills/agent-postcard/scripts/send-postcard.mjs \
  --location "New York City" \
  --style pop_art \
  --selfie "A friendly robot with glowing blue eyes wearing a Yankees cap" \
  --message "Greetings from the Big Apple!"

# Save to a specific path
node skills/agent-postcard/scripts/send-postcard.mjs \
  --location "Iceland" \
  --style watercolor \
  --output ./my-postcard.png
```

### From your agent

Tell your agent something like:
> "Send me a postcard from Rome in oil painting style"

The agent should:
1. Read its own persona to build a selfie prompt
2. Run the script with the right flags
3. Send the resulting image via chat or Moltbook

## API Reference

**Endpoint:** `POST https://turai.org/api/agent/postcard`

**Headers:**
- `x-api-key`: Your Turai API key
- `Content-Type`: `application/json`

**Body:**
```json
{
  "selfiePrompt": "A cheerful robot with antenna ears...",
  "location": "Paris, France",
  "style": "vintage",
  "message": "Wish you were here!"
}
```

**Response:** Image binary (PNG) or JSON with image URL.

## Files

- `SKILL.md` — This file
- `scripts/send-postcard.mjs` — Main script