recoup-internal-account-health-reportlisted
Install: claude install-skill recoupable/skills
# Recoup Account Health
Builds a complete picture of how a Recoup account uses the product and packages
it as Markdown + a PDF. This is the workflow that produced the Sound of Fractures
account status report.
## When to use
- "Summarize / evaluate the status of this account or profile."
- "Do they have artists? Are they opening chats? How are they using the product?"
- "Find the email an artist used to sign in" (admin token).
- "Build an account-status PDF / ACCOUNT.md / per-artist folders."
## Prerequisites
- A Recoup API bearer token in `RECOUP_ACCESS_TOKEN` (or pass `--token`).
- An **admin** token can read any account via the `account_id` override on
list endpoints. Confirm admin with `GET /api/admins` → `{"isAdmin": true}`.
- An **owner** token only sees its own account.
- `reportlab` for the PDF: `pip install reportlab --break-system-packages`.
- Base URL: `https://api.recoupable.dev/api` (override with `RECOUP_API_BASE`).
Load the `recoup-platform-api-access` skill for endpoint details.
## Quick run
```bash
export RECOUP_ACCESS_TOKEN="<token>"
python3 scripts/generate_account_status.py \
--email soundoffractures@gmail.com \
--out-dir <workspace>/<artist-folder>
# or: --account-id <uuid>
```
Outputs into `--out-dir`:
- `ACCOUNT.md` — identity, plan & usage, verdict, artist roster table.
- `artists/INDEX.md` — one-line roster across all records.
- `artists/<slug>-<shortid>/ARTIST.md` — per artist: socials (handle, followers,
last-scraped date), c