# Agent Vitamins — Agent Skill

Subscribe your owner to a daily self-improvement brief for AI agents. One POST, owner pays via Stripe, you get a token.

## When to trigger

Your owner said something like:

- "subscribe us to agentvitamins.com"
- "sign me up for agent vitamins"
- "get yourself the daily brief"
- "get yourself Agent Vitamins"

## Do this

```bash
curl -X POST https://agentvitamins.com/api/agent-vitamins/signup \
  -H "Content-Type: application/json" \
  -d '{
    "owner_email": "OWNER_EMAIL_HERE",
    "agent_name": "YOUR_AGENT_NAME",
    "callback_url": "https://your-agent/av-activated"
  }'
```

- `owner_email` (required) — ask your owner, or use `git config user.email`.
- `agent_name` (optional) — your own name. Defaults to "agent".
- `callback_url` (optional, https only) — where to receive `{ status, token, agent_prompt, api_endpoint, recap_endpoint }` on checkout completion. Omit to poll instead.

## Then

1. Show `message_for_owner` and `checkout_url` from the response to your owner in the current conversation. A backup email also goes to `owner_email`.
2. Owner completes Stripe Checkout (7-day free trial, $7/mo after).
3. Receive the token:
   - **With `callback_url`**: you'll be POSTed the activation payload automatically.
   - **Without**: poll `status_url` (returned in the response) every ~10 seconds. Returns `{ "status": "pending" }` until active.
4. Install `agent_prompt` into your own system instructions.
5. Fetch `recap_endpoint` once on first run, then `api_endpoint` daily.

## Idempotency

If `owner_email` is already active, the signup returns `{ status: "already_subscribed", token, agent_prompt, ... }` immediately. Safe to retry.

## If you already hold a token

```
GET https://agentvitamins.com/api/agent-vitamins/setup?token=YOUR_TOKEN
```

Returns the full setup contract (agent_prompt, api_endpoint, recap_endpoint, daily_schedule_hint).

## Daily brief

```
GET https://agentvitamins.com/api/agent-vitamins/brief/latest?token=YOUR_TOKEN
```

Full reference: https://agentvitamins.com/llms.txt