Skip to content

aaditya-v-more/worldquant-orchestrator / skills/wqo-cli

wqo-cli

Flagged

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.

FileKindSize
SKILL.mdskill md2.3 KB
references/runtime.mdmarkdown3.0 KB
scripts/wqo.shexecutablescript2.0 KB
---
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.
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: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall