aaditya-v-more/worldquant-orchestrator / skills/wqo-auth
wqo-auth
VerifiedAuthenticate WQO with WorldQuant BRAIN and handle session errors or human Persona verification. Use for login, logout, account authentication status and quota checks.
WorldQuant BRAIN — authentication
Setup
Read setup and operational boundaries before running
commands. Use the bundled scripts/wqo.sh runner for every wqo command below;
it installs the CLI locally when missing. This skill works without other skills
or a source checkout.
What this account can do
Run wqo auth status for your account and learned concurrency. The observations
below came from a NONE account on 2026-07-30 and were not re-probed in the
2026-09-07 documentation review; they are not universal tier limits:
- ~1 simulation slot. Batches run near-sequentially; 40 candidates is roughly
an hour of wall clock. Concurrency is learned from 429s and persisted — do not
override it with
WQO_MAX_CONCURRENCY. - 66 operators, not the full set. Check
wqo data operatorsbefore suggesting one. /alphas/{id}/correlations/prodreturns 403. TheMATCHES_COMPETITIONcheck still runs server-side, so the gate verdict is real; only the breakdown is unreadable./users/self/consultantreturns 403.
Re-run wqo account probe after a level change to see what opened up.
Commands
wqo auth status
Prints the logged-in user, daily simulation/submission usage against budget, and the learned concurrency. Run this first in a session — it authenticates using the cached cookie if one is valid, and only re-authenticates when it isn't.
wqo auth login # force a fresh login
wqo auth persona # finish a biometric check
wqo auth logout # drop the cached session
Credentials
Credentials live in ~/.brain_credentials.json, created by the user:
{"email": "...", "password": "..."}
Never write, edit, echo, or read back this file's contents. If it is missing,
tell the user to create it themselves and run chmod 600 ~/.brain_credentials.json.
Do not offer to type the password for them.
Biometric verification
Authentication may require a Persona identity check. When that happens the command exits with code 2 and prints a URL. This is not an error to work around:
- Give the user the URL and ask them to complete it in a browser.
- Wait for them to say they're done.
- Run
wqo auth persona.
Never attempt to bypass, automate, or solve this check.
Exit codes
| Code | Meaning | Action |
|---|---|---|
| 0 | fine | continue |
| 2 | auth required or biometric pending | read stderr, follow the biometric flow above |
| 3 | daily budget exhausted | stop; tell the user, don't raise the cap without asking |
Companion skill names above are optional guidance. If none are installed, use
the equivalent wqo command through this skill's bundled runner.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |