DrugFlow Skills

Route requests to the correct DrugFlow API flow and execute with minimal ambiguity.

Flow Selection

1. Read references/index.md first.
2. Match user intent to one flow.
3. Load only that flow's reference files.
4. Prefer script execution from scripts/<flow>/ when available.

Current Flows

1. Common APIs: reusable auth/workspace/balance/jobs APIs available.
2. Virtual screening: complete flow available.
3. Docking: complete flow available.
4. ADMET: complete flow available.
5. Rescoring: complete flow available.
6. Structure extract: complete flow available (img2mol backend type).
7. Molecular factory: complete flow available (with atom-selection helpers).

Common APIs Workflow

1. Read references/flows/common-apis/call-flow.md.
2. Read references/flows/common-apis/payloads.md.
3. Reuse scripts/common/drugflow_api.py for:

• signin
• signup
• list_workspaces / create_workspace / ensure_workspace
• get_balance
• list_jobs

4. Use scripts/common/test_common_apis.py for direct smoke tests.

Virtual Screening Workflow

1. Read references/flows/virtual-screening/call-flow.md.
2. Read references/flows/virtual-screening/payloads.md.
3. Use scripts/virtual-screening/run_vs_flow.py for end-to-end execution.
4. Always include ws_id for /api/jobs list/detail.
5. For /api/jobs create, pass name, type, args (JSON string), ws_id; in non-private mode include expect_tokens and avail_tokens.

Docking Workflow

1. Read references/flows/docking/call-flow.md.
2. Read references/flows/docking/payloads.md.
3. Use scripts/docking/run_docking_flow.py for end-to-end execution.
4. Create docking jobs through POST /api/jobs with multipart fields pdb, ligands, pdb_content, and args.
5. Site-driven docking box note: when --site is provided but center/size/radius are omitted, the script auto-derives the docking box from that site in local PDB.
6. Always include ws_id on job list/detail requests and pass expect_tokens/avail_tokens in non-private mode.

ADMET Workflow

1. Read references/flows/admet/call-flow.md.
2. Read references/flows/admet/payloads.md.
3. Use scripts/admet/run_admet_flow.py for end-to-end execution.
4. ADMET job type is fixed to admet-dl.
5. Support two input modes:

• direct smiles list
• dataset mode via dataset_id + smiles_col

6. For /api/jobs create, pass name, type=admet-dl, args, ws_id, and in non-private mode expect_tokens/avail_tokens.