[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CYNQQW2J6M74EQBJRT3BME":3,"skill-same:01M7CYNQQW2J6M74EQBJRT3BME":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7CYNQQW2J6M74EQBJRT3BME","pytdc",null,"Therapeutics Data Commons. AI-ready drug discovery datasets (ADME, toxicity, DTI), benchmarks, scaffold splits, molecular oracles, for therapeutic ML and pharmacological prediction.","Marvin-LiJunZan\u002Fskills-mcp","Marvin-LiJunZan","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F125227190?v=4","01M7CX941DQ6NV1MXY88ZDKVFM","lijunzan","01M7CX9421GJQ55X6W4259Y8V6",0,"MIT","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pytdc\ndescription: Therapeutics Data Commons. AI-ready drug discovery datasets (ADME, toxicity, DTI), benchmarks, scaffold splits, molecular oracles, for therapeutic ML and pharmacological prediction.\nlicense: MIT license\nmetadata:\n    skill-author: K-Dense Inc.\n---\n\n# PyTDC (Therapeutics Data Commons)\n\n## Overview\n\nPyTDC is an open-science platform providing AI-ready datasets and benchmarks for drug discovery and development. Access curated datasets spanning the entire therapeutics pipeline with standardized evaluation metrics and meaningful data splits, organized into three categories: single-instance prediction (molecular\u002Fprotein properties), multi-instance prediction (drug-target interactions, DDI), and generation (molecule generation, retrosynthesis).\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Working with drug discovery or therapeutic ML datasets\n- Benchmarking machine learning models on standardized pharmaceutical tasks\n- Predicting molecular properties (ADME, toxicity, bioactivity)\n- Predicting drug-target or drug-drug interactions\n- Generating novel molecules with desired properties\n- Accessing curated datasets with proper train\u002Ftest splits (scaffold, cold-split)\n- Using molecular oracles for property optimization\n\n## Installation & Setup\n\nInstall PyTDC using pip:\n\n```bash\nuv pip install PyTDC\n```\n\nTo upgrade to the latest version:\n\n```bash\nuv pip install PyTDC --upgrade\n```\n\nCore dependencies (automatically installed):\n- numpy, pandas, tqdm, seaborn, scikit_learn, fuzzywuzzy\n\nAdditional packages are installed automatically as needed for specific features.\n\n## Quick Start\n\nThe basic pattern for accessing any TDC dataset follows this structure:\n\n```python\nfrom tdc.\u003Cproblem> import \u003CTask>\ndata = \u003CTask>(name='\u003CDataset>')\nsplit = data.get_split(method='scaffold', seed=1, frac=[0.7, 0.1, 0.2])\ndf = data.get_data(format='df')\n```\n\nWhere:\n- `\u003Cproblem>`: One of `single_pred`, `multi_pred`, or `generation`\n- `\u003CTask>`: Specific task category (e.g., ADME, DTI, MolGen)\n- `\u003CDataset>`: Dataset name within that task\n\n**Example - Loading ADME data:**\n\n```python\nfrom tdc.single_pred import ADME\ndata = ADME(name='Caco2_Wang')\nsplit = data.get_split(method='scaffold')\n# Returns dict with 'train', 'valid', 'test' DataFrames\n```\n\n## Single-Instance Prediction Tasks\n\nSingle-instance prediction involves forecasting properties of individual biomedical entities (molecules, proteins, etc.).\n\n### Available Task Categories\n\n#### 1. ADME (Absorption, Distribution, Metabolism, Excretion)\n\nPredict pharmacokinetic properties of drug molecules.\n\n```python\nfrom tdc.single_pred import ADME\ndata = ADME(name='Caco2_Wang')  # Intestinal permeability\n# Other datasets: HIA_Hou, Bioavailability_Ma, Lipophilicity_AstraZeneca, etc.\n```\n\n**Common ADME datasets:**\n- Caco2 - Intestinal permeability\n- HIA - Human intestinal absorption\n- Bioavailability - Oral bioavailability\n- Lipophilicity - Octanol-water partition coefficient\n- Solubility - Aqueous solubility\n- BBB - Blood-brain barrier penetration\n- CYP - Cytochrome P450 metabolism\n\n#### 2. Toxicity (Tox)\n\nPredict toxicity and adverse effects of compounds.\n\n```python\nfrom tdc.single_pred import Tox\ndata = Tox(name='hERG')  # Cardiotoxicity\n# Other datasets: AMES, DILI, Carcinogens_Lagunin, etc.\n```\n\n**Common toxicity datasets:**\n- hERG - Cardiac toxicity\n- AMES - Mutagenicity\n- DILI - Drug-induced liver injury\n- Carcinogens - Carcinogenicity\n- ClinTox - Clinical trial toxicity\n\n#### 3. HTS (High-Throughput Screening)\n\nBioactivity predictions from screening data.\n\n```python\nfrom tdc.single_pred import HTS\ndata = HTS(name='SARSCoV2_Vitro_Touret')\n```\n\n#### 4. QM (Quantum Mechanics)\n\nQuantum mechanical properties of molecules.\n\n```python\nfrom tdc.single_pred import QM\ndata = QM(name='QM7')\n```\n\n#### 5. Other Single Prediction Tasks\n\n- **Yields**: Chemical reaction yield prediction\n- **Epitope**: Epitope prediction for biologics\n- **Develop**: Development-stage predictions\n- **CRISPROutcome**: Gene editing outcome prediction\n\n### Data Format\n\nSingle prediction datasets typically return DataFrames with columns:\n- `Drug_ID` or `Compound_ID`: Unique identifier\n- `Drug` or `X`: SMILES string or molecular representation\n- `Y`: Target label (continuous or binary)\n\n## Multi-Instance Prediction Tasks\n\nMulti-instance prediction involves forecasting properties of interactions between multiple biomedical entities.\n\n### Available Task Categories\n\n#### 1. DTI (Drug-Target Interaction)\n\nPredict binding affinity between drugs and protein targets.\n\n```python\nfrom tdc.multi_pred import DTI\ndata = DTI(name='BindingDB_Kd')\nsplit = data.get_split()\n```\n\n**Available datasets:**\n- BindingDB_Kd - Dissociation constant (52,284 pairs)\n- BindingDB_IC50 - Half-maximal inhibitory concentration (991,486 pairs)\n- BindingDB_Ki - Inhibition constant (375,032 pairs)\n- DAVIS, KIBA - Kinase binding datasets\n\n**Data format:** Drug_ID, Target_ID, Drug (SMILES), Target (sequence), Y (binding affinity)\n\n#### 2. DDI (Drug-Drug Interaction)\n\nPredict interactions between drug pairs.\n\n```python\nfrom tdc.multi_pred import DDI\ndata = DDI(name='DrugBank')\nsplit = data.get_split()\n```\n\nMulti-class classification task predicting interaction types. Dataset contains 191,808 DDI pairs with 1,706 drugs.\n\n#### 3. PPI (Protein-Protein Interaction)\n\nPredict protein-protein interactions.\n\n```python\nfrom tdc.multi_pred import PPI\ndata = PPI(name='HuRI')\n```\n\n#### 4. Other Multi-Prediction Tasks\n\n- **GDA**: Gene-disease associations\n- **DrugRes**: Drug resistance prediction\n- **DrugSyn**: Drug synergy prediction\n- **PeptideMHC**: Peptide-MHC binding\n- **AntibodyAff**: Antibody affinity prediction\n- **MTI**: miRNA-target interactions\n- **Catalyst**: Catalyst prediction\n- **TrialOutcome**: Clinical trial outcome prediction\n\n## Generation Tasks\n\nGeneration tasks involve creating novel biomedical entities with desired properties.\n\n### 1. Molecular Generation (MolGen)\n\nGenerate diverse, novel molecules with desirable chemical properties.\n\n```python\nfrom tdc.generation import MolGen\ndata = MolGen(name='ChEMBL_V29')\nsplit = data.get_split()\n```\n\nUse with oracles to optimize for specific properties:\n\n```python\nfrom tdc import Oracle\noracle = Oracle(name='GSK3B')\nscore = oracle('CC(C)Cc1ccc(cc1)C(C)C(O)=O')  # Evaluate SMILES\n```\n\nSee `references\u002Foracles.md` for all available oracle functions.\n\n### 2. Retrosynthesis (RetroSyn)\n\nPredict reactants needed to synthesize a target molecule.\n\n```python\nfrom tdc.generation import RetroSyn\ndata = RetroSyn(name='USPTO')\nsplit = data.get_split()\n```\n\nDataset contains 1,939,253 reactions from USPTO database.\n\n### 3. Paired Molecule Generation\n\nGenerate molecule pairs (e.g., prodrug-drug pairs).\n\n```python\nfrom tdc.generation import PairMolGen\ndata = PairMolGen(name='Prodrug')\n```\n\nFor detailed oracle documentation and molecular generation workflows, refer to `references\u002Foracles.md` and `scripts\u002Fmolecular_generation.py`.\n\n## Benchmark Groups\n\nBenchmark groups provide curated collections of related datasets for systematic model evaluation.\n\n### ADMET Benchmark Group\n\n```python\nfrom tdc.benchmark_group import admet_group\ngroup = admet_group(path='data\u002F')\n\n# Get benchmark datasets\nbenchmark = group.get('Caco2_Wang')\npredictions = {}\n\nfor seed in [1, 2, 3, 4, 5]:\n    train, valid = benchmark['train'], benchmark['valid']\n    # Train model here\n    predictions[seed] = model.predict(benchmark['test'])\n\n# Evaluate with required 5 seeds\nresults = group.evaluate(predictions)\n```\n\n**ADMET Group includes 22 datasets** covering absorption, distribution, metabolism, excretion, and toxicity.\n\n### Other Benchmark Groups\n\nAvailable benchmark groups include collections for:\n- ADMET properties\n- Drug-target interactions\n- Drug combination prediction\n- And more specialized therapeutic tasks\n\nFor benchmark evaluation workflows, see `scripts\u002Fbenchmark_evaluation.py`.\n\n## Data Functions\n\nTDC provides comprehensive data processing utilities organized into four categories.\n\n### 1. Dataset Splits\n\nRetrieve train\u002Fvalidation\u002Ftest partitions with various strategies:\n\n```python\n# Scaffold split (default for most tasks)\nsplit = data.get_split(method='scaffold', seed=1, frac=[0.7, 0.1, 0.2])\n\n# Random split\nsplit = data.get_split(method='random', seed=42, frac=[0.8, 0.1, 0.1])\n\n# Cold split (for DTI\u002FDDI tasks)\nsplit = data.get_split(method='cold_drug', seed=1)  # Unseen drugs in test\nsplit = data.get_split(method='cold_target', seed=1)  # Unseen targets in test\n```\n\n**Available split strategies:**\n- `random`: Random shuffling\n- `scaffold`: Scaffold-based (for chemical diversity)\n- `cold_drug`, `cold_target`, `cold_drug_target`: For DTI tasks\n- `temporal`: Time-based splits for temporal datasets\n\n### 2. Model Evaluation\n\nUse standardized metrics for evaluation:\n\n```python\nfrom tdc import Evaluator\n\n# For binary classification\nevaluator = Evaluator(name='ROC-AUC')\nscore = evaluator(y_true, y_pred)\n\n# For regression\nevaluator = Evaluator(name='RMSE')\nscore = evaluator(y_true, y_pred)\n```\n\n**Available metrics:** ROC-AUC, PR-AUC, F1, Accuracy, RMSE, MAE, R2, Spearman, Pearson, and more.\n\n### 3. Data Processing\n\nTDC provides 11 key processing utilities:\n\n```python\nfrom tdc.chem_utils import MolConvert\n\n# Molecule format conversion\nconverter = MolConvert(src='SMILES', dst='PyG')\npyg_graph = converter('CC(C)Cc1ccc(cc1)C(C)C(O)=O')\n```\n\n**Processing utilities include:**\n- Molecule format conversion (SMILES, SELFIES, PyG, DGL, ECFP, etc.)\n- Molecule filters (PAINS, drug-likeness)\n- Label binarization and unit conversion\n- Data balancing (over\u002Funder-sampling)\n- Negative sampling for pair data\n- Graph transformation\n- Entity retrieval (CID to SMILES, UniProt to sequence)\n\nFor comprehensive utilities documentation, see `references\u002Futilities.md`.\n\n### 4. Molecule Generation Oracles\n\nTDC provides 17+ oracle functions for molecular optimization:\n\n```python\nfrom tdc import Oracle\n\n# Single oracle\noracle = Oracle(name='DRD2')\nscore = oracle('CC(C)Cc1ccc(cc1)C(C)C(O)=O')\n\n# Multiple oracles\noracle = Oracle(name='JNK3')\nscores = oracle(['SMILES1', 'SMILES2', 'SMILES3'])\n```\n\nFor complete oracle documentation, see `references\u002Foracles.md`.\n\n## Advanced Features\n\n### Retrieve Available Datasets\n\n```python\nfrom tdc.utils import retrieve_dataset_names\n\n# Get all ADME datasets\nadme_datasets = retrieve_dataset_names('ADME')\n\n# Get all DTI datasets\ndti_datasets = retrieve_dataset_names('DTI')\n```\n\n### Label Transformations\n\n```python\n# Get label mapping\nlabel_map = data.get_label_map(name='DrugBank')\n\n# Convert labels\nfrom tdc.chem_utils import label_transform\ntransformed = label_transform(y, from_unit='nM', to_unit='p')\n```\n\n### Database Queries\n\n```python\nfrom tdc.utils import cid2smiles, uniprot2seq\n\n# Convert PubChem CID to SMILES\nsmiles = cid2smiles(2244)\n\n# Convert UniProt ID to amino acid sequence\nsequence = uniprot2seq('P12345')\n```\n\n## Common Workflows\n\n### Workflow 1: Train a Single Prediction Model\n\nSee `scripts\u002Fload_and_split_data.py` for a complete example:\n\n```python\nfrom tdc.single_pred import ADME\nfrom tdc import Evaluator\n\n# Load data\ndata = ADME(name='Caco2_Wang')\nsplit = data.get_split(method='scaffold', seed=42)\n\ntrain, valid, test = split['train'], split['valid'], split['test']\n\n# Train model (user implements)\n# model.fit(train['Drug'], train['Y'])\n\n# Evaluate\nevaluator = Evaluator(name='MAE')\n# score = evaluator(test['Y'], predictions)\n```\n\n### Workflow 2: Benchmark Evaluation\n\nSee `scripts\u002Fbenchmark_evaluation.py` for a complete example with multiple seeds and proper evaluation protocol.\n\n### Workflow 3: Molecular Generation with Oracles\n\nSee `scripts\u002Fmolecular_generation.py` for an example of goal-directed generation using oracle functions.\n\n## Resources\n\nThis skill includes bundled resources for common TDC workflows:\n\n### scripts\u002F\n\n- `load_and_split_data.py`: Template for loading and splitting TDC datasets with various strategies\n- `benchmark_evaluation.py`: Template for running benchmark group evaluations with proper 5-seed protocol\n- `molecular_generation.py`: Template for molecular generation using oracle functions\n\n### references\u002F\n\n- `datasets.md`: Comprehensive catalog of all available datasets organized by task type\n- `oracles.md`: Complete documentation of all 17+ molecule generation oracles\n- `utilities.md`: Detailed guide to data processing, splitting, and evaluation utilities\n\n## Additional Resources\n\n- **Official Website**: https:\u002F\u002Ftdcommons.ai\n- **Documentation**: https:\u002F\u002Ftdc.readthedocs.io\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fmims-harvard\u002FTDC\n- **Paper**: NeurIPS 2021 - \"Therapeutics Data Commons: Machine Learning Datasets and Tasks for Drug Discovery and Development\"\n\n","# PyTDC (Therapeutics Data Commons)\n\n## Overview\n\nPyTDC is an open-science platform providing AI-ready datasets and benchmarks for drug discovery and development. Access curated datasets spanning the entire therapeutics pipeline with standardized evaluation metrics and meaningful data splits, organized into three categories: single-instance prediction (molecular\u002Fprotein properties), multi-instance prediction (drug-target interactions, DDI), and generation (molecule generation, retrosynthesis).\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Working with drug discovery or therapeutic ML datasets\n- Benchmarking machine learning models on standardized pharmaceutical tasks\n- Predicting molecular properties (ADME, toxicity, bioactivity)\n- Predicting drug-target or drug-drug interactions\n- Generating novel molecules with desired properties\n- Accessing curated datasets with proper train\u002Ftest splits (scaffold, cold-split)\n- Using molecular oracles for property optimization\n\n## Installation & Setup\n\nInstall PyTDC using pip:\n\n```bash\nuv pip install PyTDC\n```\n\nTo upgrade to the latest version:\n\n```bash\nuv pip install PyTDC --upgrade\n```\n\nCore dependencies (automatically installed):\n- numpy, pandas, tqdm, seaborn, scikit_learn, fuzzywuzzy\n\nAdditional packages are installed automatically as needed for specific features.\n\n## Quick Start\n\nThe basic pattern for accessing any TDC dataset follows this structure:\n\n```python\nfrom tdc.\u003Cproblem> import \u003CTask>\ndata = \u003CTask>(name='\u003CDataset>')\nsplit = data.get_split(method='scaffold', seed=1, frac=[0.7, 0.1, 0.2])\ndf = data.get_data(format='df')\n```\n\nWhere:\n- `\u003Cproblem>`: One of `single_pred`, `multi_pred`, or `generation`\n- `\u003CTask>`: Specific task category (e.g., ADME, DTI, MolGen)\n- `\u003CDataset>`: Dataset name within that task\n\n**Example - Loading ADME data:**\n\n```python\nfrom tdc.single_pred import ADME\ndata = ADME(name='Caco2_Wang')\nsplit = data.get_split(method='scaffold')\n# Returns dict with 'train', 'valid', 'test' DataFrames\n```\n\n## Single-Instance Prediction Tasks\n\nSingle-instance prediction involves forecasting properties of individual biomedical entities (molecules, proteins, etc.).\n\n### Available Task Categories\n\n#### 1. ADME (Absorption, Distribution, Metabolism, Excretion)\n\nPredict pharmacokinetic properties of drug molecules.\n\n```python\nfrom tdc.single_pred import ADME\ndata = ADME(name='Caco2_Wang')  # Intestinal permeability\n# Other datasets: HIA_Hou, Bioavailability_Ma, Lipophilicity_AstraZeneca, etc.\n```\n\n**Common ADME datasets:**\n- Caco2 - Intestinal permeability\n- HIA - Human intestinal absorption\n- Bioavailability - Oral bioavailability\n- Lipophilicity - Octanol-water partition coefficient\n- Solubility - Aqueous solubility\n- BBB - Blood-brain barrier penetration\n- CYP - Cytochrome P450 metabolism\n\n#### 2. Toxicity (Tox)\n\nPredict toxicity and adverse effects of compounds.\n\n```python\nfrom tdc.single_pred import Tox\ndata = Tox(name='hERG')  # Cardiotoxicity\n# Other datasets: AMES, DILI, Carcinogens_Lagunin, etc.\n```\n\n**Common toxicity datasets:**\n- hERG - Cardiac toxicity\n- AMES - Mutagenicity\n- DILI - Drug-induced liver injury\n- Carcinogens - Carcinogenicity\n- ClinTox - Clinical trial toxicity\n\n#### 3. HTS (High-Throughput Screening)\n\nBioactivity predictions from screening data.\n\n```python\nfrom tdc.single_pred import HTS\ndata = HTS(name='SARSCoV2_Vitro_Touret')\n```\n\n#### 4. QM (Quantum Mechanics)\n\nQuantum mechanical properties of molecules.\n\n```python\nfrom tdc.single_pred import QM\ndata = QM(name='QM7')\n```\n\n#### 5. Other Single Prediction Tasks\n\n- **Yields**: Chemical reaction yield prediction\n- **Epitope**: Epitope prediction for biologics\n- **Develop**: Development-stage predictions\n- **CRISPROutcome**: Gene editing outcome prediction\n\n### Data Format\n\nSingle prediction datasets typically return DataFrames with columns:\n- `Drug_ID` or `Compound_ID`: Unique identifier\n- `Drug` or `X`: SMILES string or molecular representation\n- `Y`: Target label (continuous or binary)\n\n## Multi-Instance Prediction Tasks\n\nMulti-instance prediction involves forecasting properties of interactions between multiple biomedical entities.\n\n### Available Task Categories\n\n#### 1. DTI (Drug-Target Interaction)\n\nPredict binding affinity between drugs and protein targets.\n\n```python\nfrom tdc.multi_pred import DTI\ndata = DTI(name='BindingDB_Kd')\nsplit = data.get_split()\n```\n\n**Available datasets:**\n- BindingDB_Kd - Dissociation constant (52,284 pairs)\n- BindingDB_IC50 - Half-maximal inhibitory concentration (991,486 pairs)\n- BindingDB_Ki - Inhibition constant (375,032 pairs)\n- DAVIS, KIBA - Kinase binding datasets\n\n**Data format:** Drug_ID, Target_ID, Drug (SMILES), Target (sequence), Y (binding affinity)\n\n#### 2. DDI (Drug-Drug Interaction)\n\nPredict interactions between drug pairs.\n\n```python\nfrom tdc.multi_pred import DDI\ndata = DDI(name='DrugBank')\nsplit = data.get_split()\n```\n\nMulti-class classification task predicting interaction types. Dataset contains 191,808 DDI pairs with 1,706 drugs.\n\n#### 3. PPI (Protein-Protein Interaction)\n\nPredict protein-protein interactions.\n\n```python\nfrom tdc.multi_pred import PPI\ndata = PPI(name='HuRI')\n```\n\n#### 4. Other Multi-Prediction Tasks\n\n- **GDA**: Gene-disease associations\n- **DrugRes**: Drug resistance prediction\n- **DrugSyn**: Drug synergy prediction\n- **PeptideMHC**: Peptide-MHC binding\n- **AntibodyAff**: Antibody affinity prediction\n- **MTI**: miRNA-target interactions\n- **Catalyst**: Catalyst prediction\n- **TrialOutcome**: Clinical trial outcome prediction\n\n## Generation Tasks\n\nGeneration tasks involve creating novel biomedical entities with desired properties.\n\n### 1. Molecular Generation (MolGen)\n\nGenerate diverse, novel molecules with desirable chemical properties.\n\n```python\nfrom tdc.generation import MolGen\ndata = MolGen(name='ChEMBL_V29')\nsplit = data.get_split()\n```\n\nUse with oracles to optimize for specific properties:\n\n```python\nfrom tdc import Oracle\noracle = Oracle(name='GSK3B')\nscore = oracle('CC(C)Cc1ccc(cc1)C(C)C(O)=O')  # Evaluate SMILES\n```\n\nSee `references\u002Foracles.md` for all available oracle functions.\n\n### 2. Retrosynthesis (RetroSyn)\n\nPredict reactants needed to synthesize a target molecule.\n\n```python\nfrom tdc.generation import RetroSyn\ndata = RetroSyn(name='USPTO')\nsplit = data.get_split()\n```\n\nDataset contains 1,939,253 reactions from USPTO database.\n\n### 3. Paired Molecule Generation\n\nGenerate molecule pairs (e.g., prodrug-drug pairs).\n\n```python\nfrom tdc.generation import PairMolGen\ndata = PairMolGen(name='Prodrug')\n```\n\nFor detailed oracle documentation and molecular generation workflows, refer to `references\u002Foracles.md` and `scripts\u002Fmolecular_generation.py`.\n\n## Benchmark Groups\n\nBenchmark groups provide curated collections of related datasets for systematic model evaluation.\n\n### ADMET Benchmark Group\n\n```python\nfrom tdc.benchmark_group import admet_group\ngroup = admet_group(path='data\u002F')\n\n# Get benchmark datasets\nbenchmark = group.get('Caco2_Wang')\npredictions = {}\n\nfor seed in [1, 2, 3, 4, 5]:\n    train, valid = benchmark['train'], benchmark['valid']\n    # Train model here\n    predictions[seed] = model.predict(benchmark['test'])\n\n# Evaluate with required 5 seeds\nresults = group.evaluate(predictions)\n```\n\n**ADMET Group includes 22 datasets** covering absorption, distribution, metabolism, excretion, and toxicity.\n\n### Other Benchmark Groups\n\nAvailable benchmark groups include collections for:\n- ADMET properties\n- Drug-target interactions\n- Drug combination prediction\n- And more specialized therapeutic tasks\n\nFor benchmark evaluation workflows, see `scripts\u002Fbenchmark_evaluation.py`.\n\n## Data Functions\n\nTDC provides comprehensive data processing utilities organized into four categories.\n\n### 1. Dataset Splits\n\nRetrieve train\u002Fvalidation\u002Ftest partitions with various strategies:\n\n```python\n# Scaffold split (default for most tasks)\nsplit = data.get_split(method='scaffold', seed=1, frac=[0.7, 0.1, 0.2])\n\n# Random split\nsplit = data.get_split(method='random', seed=42, frac=[0.8, 0.1, 0.1])\n\n# Cold split (for DTI\u002FDDI tasks)\nsplit = data.get_split(method='cold_drug', seed=1)  # Unseen drugs in test\nsplit = data.get_split(method='cold_target', seed=1)  # Unseen targets in test\n```\n\n**Available split strategies:**\n- `random`: Random shuffling\n- `scaffold`: Scaffold-based (for chemical diversity)\n- `cold_drug`, `cold_target`, `cold_drug_target`: For DTI tasks\n- `temporal`: Time-based splits for temporal datasets\n\n### 2. Model Evaluation\n\nUse standardized metrics for evaluation:\n\n```python\nfrom tdc import Evaluator\n\n# For binary classification\nevaluator = Evaluator(name='ROC-AUC')\nscore = evaluator(y_true, y_pred)\n\n# For regression\nevaluator = Evaluator(name='RMSE')\nscore = evaluator(y_true, y_pred)\n```\n\n**Available metrics:** ROC-AUC, PR-AUC, F1, Accuracy, RMSE, MAE, R2, Spearman, Pearson, and more.\n\n### 3. Data Processing\n\nTDC provides 11 key processing utilities:\n\n```python\nfrom tdc.chem_utils import MolConvert\n\n# Molecule format conversion\nconverter = MolConvert(src='SMILES', dst='PyG')\npyg_graph = converter('CC(C)Cc1ccc(cc1)C(C)C(O)=O')\n```\n\n**Processing utilities include:**\n- Molecule format conversion (SMILES, SELFIES, PyG, DGL, ECFP, etc.)\n- Molecule filters (PAINS, drug-likeness)\n- Label binarization and unit conversion\n- Data balancing (over\u002Funder-sampling)\n- Negative sampling for pair data\n- Graph transformation\n- Entity retrieval (CID to SMILES, UniProt to sequence)\n\nFor comprehensive utilities documentation, see `references\u002Futilities.md`.\n\n### 4. Molecule Generation Oracles\n\nTDC provides 17+ oracle functions for molecular optimization:\n\n```python\nfrom tdc import Oracle\n\n# Single oracle\noracle = Oracle(name='DRD2')\nscore = oracle('CC(C)Cc1ccc(cc1)C(C)C(O)=O')\n\n# Multiple oracles\noracle = Oracle(name='JNK3')\nscores = oracle(['SMILES1', 'SMILES2', 'SMILES3'])\n```\n\nFor complete oracle documentation, see `references\u002Foracles.md`.\n\n## Advanced Features\n\n### Retrieve Available Datasets\n\n```python\nfrom tdc.utils import retrieve_dataset_names\n\n# Get all ADME datasets\nadme_datasets = retrieve_dataset_names('ADME')\n\n# Get all DTI datasets\ndti_datasets = retrieve_dataset_names('DTI')\n```\n\n### Label Transformations\n\n```python\n# Get label mapping\nlabel_map = data.get_label_map(name='DrugBank')\n\n# Convert labels\nfrom tdc.chem_utils import label_transform\ntransformed = label_transform(y, from_unit='nM', to_unit='p')\n```\n\n### Database Queries\n\n```python\nfrom tdc.utils import cid2smiles, uniprot2seq\n\n# Convert PubChem CID to SMILES\nsmiles = cid2smiles(2244)\n\n# Convert UniProt ID to amino acid sequence\nsequence = uniprot2seq('P12345')\n```\n\n## Common Workflows\n\n### Workflow 1: Train a Single Prediction Model\n\nSee `scripts\u002Fload_and_split_data.py` for a complete example:\n\n```python\nfrom tdc.single_pred import ADME\nfrom tdc import Evaluator\n\n# Load data\ndata = ADME(name='Caco2_Wang')\nsplit = data.get_split(method='scaffold', seed=42)\n\ntrain, valid, test = split['train'], split['valid'], split['test']\n\n# Train model (user implements)\n# model.fit(train['Drug'], train['Y'])\n\n# Evaluate\nevaluator = Evaluator(name='MAE')\n# score = evaluator(test['Y'], predictions)\n```\n\n### Workflow 2: Benchmark Evaluation\n\nSee `scripts\u002Fbenchmark_evaluation.py` for a complete example with multiple seeds and proper evaluation protocol.\n\n### Workflow 3: Molecular Generation with Oracles\n\nSee `scripts\u002Fmolecular_generation.py` for an example of goal-directed generation using oracle functions.\n\n## Resources\n\nThis skill includes bundled resources for common TDC workflows:\n\n### scripts\u002F\n\n- `load_and_split_data.py`: Template for loading and splitting TDC datasets with various strategies\n- `benchmark_evaluation.py`: Template for running benchmark group evaluations with proper 5-seed protocol\n- `molecular_generation.py`: Template for molecular generation using oracle functions\n\n### references\u002F\n\n- `datasets.md`: Comprehensive catalog of all available datasets organized by task type\n- `oracles.md`: Complete documentation of all 17+ molecule generation oracles\n- `utilities.md`: Detailed guide to data processing, splitting, and evaluation utilities\n\n## Additional Resources\n\n- **Official Website**: https:\u002F\u002Ftdcommons.ai\n- **Documentation**: https:\u002F\u002Ftdc.readthedocs.io\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fmims-harvard\u002FTDC\n- **Paper**: NeurIPS 2021 - \"Therapeutics Data Commons: Machine Learning Datasets and Tasks for Drug Discovery and Development\"\n\n",{"name":5,"license":24,"metadata":25,"description":7},"MIT license",{"skill-author":26},"K-Dense Inc.","main","2b5bc01df8cc5820e97283a614d9873a8ac70ea1","skills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan","2026-10-17 16:33:48",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Marvin-LiJunZan\u002Fskills-mcp --skill pytdc",{"tool":39,"command":40},"bunx","bunx skills add Marvin-LiJunZan\u002Fskills-mcp --skill pytdc",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Marvin-LiJunZan\u002Fskills-mcp --skill pytdc","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002FSKILL.md",true,[47,53,57,61,67,71],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fdatasets.md","REFERENCE","参考文档",8792,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Freferences\u002Fdatasets.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Foracles.md",10051,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Freferences\u002Foracles.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Futilities.md",16045,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Freferences\u002Futilities.md",{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"scripts\u002Fbenchmark_evaluation.py","SCRIPT","脚本",9238,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Fscripts\u002Fbenchmark_evaluation.py",{"path":68,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":69,"sourceHtmlUrl":70},"scripts\u002Fload_and_split_data.py",6350,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Fscripts\u002Fload_and_split_data.py",{"path":72,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":73,"sourceHtmlUrl":74},"scripts\u002Fmolecular_generation.py",11335,"https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fclaude-scientific-skills\u002Fscientific-skills\u002Fpytdc\u002Fscripts\u002Fmolecular_generation.py",[76,84,91,98,105,112],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CZ8DB1NGKBK8AC6BKFHYFK","vibe-research-workflow","Guides AI-assisted research across three sub-flows, Vibe Coding, Vibe Figure, and Vibe Writing, with behavioural rules that keep the user in charge of academic judgment while delegating mechanical work to AI. Recommends the right tool (Cursor, Claude Code, Codex, Figma, Gemini) for the current stage. Use when the user asks 'how to use AI for research', 'Vibe Coding tips', 'AI-assisted writing workflow', 'which AI tool for this', or starts an AI-assisted work session.","CC-BY-4.0","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Fvibe-research-workflow\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CZ87M3Q1RGTAGMB61SJ18Q","tech-paper-template","Structures a technical paper's full logical skeleton using a thinking-template table (research background, limitations, key idea or goal, challenges, methodology modules, contributions), positions the paper as Technique or New Problem\u002FSetting, and runs a four-point self-consistency check. Use when the user is brainstorming a paper, discussing progress with an advisor, or planning the paper before drafting. Also use for 'paper skeleton', 'paper logic chain', 'thinking template', 'paper-structure planning'.","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Ftech-paper-template\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7CZ7ZZPBQ5C6G6YPBS2C87Q","pre-submission-reviewer","Runs a pre-submission review of a technical paper across five dimensions: macro logic, writing details, English grammar, LaTeX formatting, and figure quality. Uses a reviewer-style severity taxonomy (CRITICAL \u002F MAJOR \u002F MINOR) and flags banned AI-tone vocabulary and em-dash misuse. Use when the user asks to 'review this paper', 'audit before submission', 'check the draft', 'find issues', 'proofread', or within one week of a submission deadline.","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Fpre-submission-reviewer\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M7CZ7RMCTTP08V2C7WVWZM0A","intro-drafter","Drafts a 6-paragraph Introduction outline for a technical paper from a structured Flowchart: background and running example, existing limitations, problem essence and goal, key challenges, solution overview, contributions. Positions the paper as Technique or New Problem\u002FSetting and aligns contributions with challenges. Use when the user asks to 'draft the Introduction', 'outline the Introduction', 'intro logic needs clarifying', 'help structure the paper story', or before writing any Introduction prose.","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Fintro-drafter\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M7CZ7K5X92VSRM6WTHX91CDA","idea-evaluator","Evaluates a preliminary research idea against a five-dimension framework (Higher, Faster, Stronger, Cheaper, Broader) plus idea-lifecycle and student-capability matching, paradigm-shift probing, and a fatal-flaws audit. Returns a reviewer-style verdict. Use when the user has a draft research idea and asks whether it is worth pursuing, asks to 'evaluate this idea', 'score this idea', 'assess feasibility', 'novelty check', 'is this a good research direction', or before committing to a paper scope.","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Fidea-evaluator\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":19},"01M7CZ7D29XX445SD75ZT5E8FW","figure-designer","Advises on the design of the three core figures in a technical paper: the Motivated Example (Figure 1), the Solution Overview (Methodology), and the Experimental Results figures. Recommends the right design paradigm, layout, labelling, and tool for each figure type, then runs a quality-control audit. Use when the user asks to 'design a figure', 'draw Figure 1', 'plot experiment results', 'choose the right chart type', 'which figure tool to use', or 'figure looks unprofessional'.","https:\u002F\u002Fgithub.com\u002FMarvin-LiJunZan\u002Fskills-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fsupervisor-skills\u002Ffigure-designer\u002FSKILL.md",[],[]]