aaditya-v-more/worldquant-orchestrator / skills/wqo-cli
wqo-cli
FlaggedSet up and use the WQO command-line client for WorldQuant BRAIN research. Use for CLI installation, authentication onboarding, command discovery, or research workflows spanning data discovery, simulations, analysis and explicitly confirmed submission.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.3 KB |
| references/runtime.md | markdown | 3.0 KB |
| scripts/wqo.shexecutable | script | 2.0 KB |
SKILL.md
View on GitHub---
name: wqo-cli
description: Set up and use the WQO command-line client for WorldQuant BRAIN research. Use for CLI installation, authentication onboarding, command discovery, or research workflows spanning data discovery, simulations, analysis and explicitly confirmed submission.
---
# WQO CLI
Read [setup and operational boundaries](references/runtime.md) first. This skill
works alone. Companion skills provide deeper workflow guidance when installed.
## Start
Resolve the runner relative to this installed SKILL.md. From the user's project:
```bash
bash /absolute/path/to/wqo-cli/scripts/wqo.sh --version
bash /absolute/path/to/wqo-cli/scripts/wqo.sh --help
bash /absolute/path/to/wqo-cli/scripts/wqo.sh state
```
The runner installs missing WQO into the project's `.wqo/venv`, using PyPI.
Use this runner in place of `wqo` in the commands below, even if a shell cannot
find the command directly. No manual repository clone is required.
## Research workflow
1. `wqo auth status`: establish the account and quotas; hand Persona to the user.
2. `wqo data datasets`, `wqo data fields`, `wqo data operators`: select available
inputs matching the requested region, universe and delay.
3. `wqo sim run --code 'rank(close)'` tests one generic example;
`wqo mine --dataset DATASET_ID --budget 10 --dry-run` previews a mining run.
Live simulations consume quota; respect the user's research scope and budget.
4. `wqo gate ALPHA_ID --json` reports eligibility. Inspect failures and unavailable
checks; a good grade or attractive Sharpe is not permission to submit.
5. `wqo submit ALPHA_ID` prints the report and exits 4. Only after the user has
explicitly approved that alpha may you add `--confirm`. Never automatically
retry an uncertain submission.
Examples are illustrative; choose actual field/alpha IDs from the user's account.
Use `wqo COMMAND --help` for detailed flags and `wqo account status` for standing.
Raw `wqo api GET PATH` is read-only; it cannot bypass dedicated write safeguards.
## Optional companion skills
`wqo-auth`, `wqo-data`, `wqo-simulate`, `wqo-mine`, `wqo-analyze`, `wqo-alphas`,
`wqo-submit` and `wqo-account` each include their own runner and boundaries.
Installing one does not require the others. Skills are installed through
`npx skills add` in the user's project; never add `--global` unless requested.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |