instagram-auditlisted
Install: claude install-skill proyecto26/instagram-ai-plugin
# Instagram audit
Turn the account's own numbers into a short list of claims with evidence attached, each with a
confidence level and one action. Raw totals mostly measure follower count. Compare each post
against the account's own median instead.
## 1. Pull the data
Run from the `instagram` skill directory (`../instagram`):
```bash
npx -y bun scripts/main.ts audit [username] --limit 30 --tz <Area/City> --json > "<project-dir>/instagram-audit.json"
npx -y bun scripts/main.ts profile [username] --json > "<project-dir>/instagram-profile.json" # default: own account
```
- `<project-dir>` is the user's working folder (absolute path), never the plugin folder.
- Omit `username` for the signed-in account. Ask which timezone the audience lives in; the
default is the machine's.
- On `rate_limited`, `checkpoint` or `not_logged_in`, stop and report the hint. Do not retry.
- Check `sample.source`. "embedded, max 12" means only 12 posts could be read, so every pattern
is weak. Say so.
## 2. Read what the audit returns
| Field | Use |
|---|---|
| `account` | followers, isBusiness, category, bioChars, hasLink (inputs for the profile rubric) |
| `totals.medianEngagement`, `medianEngagementRatePct` | baseline (likes + comments, and that over followers) |
| `posts[].outlierMultiple` | engagement over the account median; 3x or more is a real hit |
| `outliers`, `underperformers` | top (3x+) and bottom (0.5x or less) posts with their hooks |
| `byFormat`, `byWeekday`, `byHour`, `byC