diffdock

Aperçu du skill diffdock

À quoi sert diffdock

DiffDock est un skill orienté docking, conçu pour prédire les poses de liaison protéine-ligand à partir d’une structure ou d’une séquence protéique, plus une entrée ligand. Utilisez le skill diffdock quand vous avez besoin d’une réponse pratique à la question « où et comment ce composé peut-il se lier ? », plutôt que d’une estimation d’affinité de liaison.

Cas d’usage idéal et limite de décision

Il convient bien à la conception de médicaments fondée sur la structure, au virtual screening et à la génération de poses pour une analyse en aval. C’est un choix moins pertinent si vous ne cherchez qu’un classement par puissance, si votre cible protéique est très flexible, ou si vous voulez un workflow chimique générique plutôt qu’un workflow de prédiction de poses.

Pourquoi il est utile

L’intérêt principal de diffdock est de combiner dans un même workflow le docking d’un complexe unique, le screening en lot, le scoring de confiance et l’entrée protéique à partir de la séquence. Cela vaut la peine d’installer diffdock quand vous voulez à la fois un chemin de docking exécutable et assez de repères pour éviter de mal interpréter les scores.

Comment utiliser le skill diffdock

Installer et inspecter le workflow

Installez le skill diffdock dans votre configuration Claude Skills, puis ouvrez d’abord SKILL.md. Ensuite, consultez references/workflows_examples.md, references/parameters_reference.md et references/confidence_and_limitations.md pour comprendre les formes d’entrée réelles, les valeurs par défaut et l’interprétation des scores avant de lancer une tâche.

Transformer votre besoin en prompt exploitable

Pour utiliser diffdock efficacement, indiquez dès le départ au skill le format de la protéine, le format du ligand et le type de tâche. Un bon prompt est précis, par exemple : « Dock this SMILES to this PDB and return the top 5 poses with confidence interpretation », ou « Prepare batch docking for these ligands against one receptor. » Un mauvais prompt se limite à « run diffdock », car on ne sait pas alors si le skill doit utiliser un fichier, une séquence ou un lot CSV.

Utiliser les bons fichiers et les bonnes sorties

Pour un docking unique, partez d’un PDB protéique et d’un ligand au format SMILES, SDF ou MOL2. Pour un traitement en lot, utilisez le modèle CSV dans assets/batch_template.csv et consultez scripts/prepare_batch_csv.py si vous devez valider les données avant exécution. Après une exécution, scripts/analyze_results.py aide à résumer les rangs des poses et les scores de confiance afin que vous n’ayez pas à inspecter manuellement chaque fichier de sortie.

Conseils pratiques de configuration

L’installation de diffdock et le premier lancement peuvent être ralentis par le téléchargement des poids du modèle et la génération de la table de recherche, donc prévoyez ce coût de mise en route. Si votre protéine n’existe pas sous forme de structure, le skill prend en charge un repliement à partir de la séquence, mais cela ajoute de l’incertitude ; utilisez cette option lorsqu’aucune structure expérimentale n’existe, pas comme raccourci par défaut. N’ajustez l’échantillonnage que lorsque la tâche est difficile, car davantage d’échantillons améliorent la couverture de recherche mais augmentent aussi le calcul et le travail de post-traitement.

FAQ du skill diffdock

diffdock fonctionne-t-il uniquement avec des fichiers PDB ?

Non. Le skill diffdock prend en charge les structures protéiques et, dans certains workflows, des séquences protéiques qui sont repliées avant le docking. Il reste toutefois préférable d’utiliser un vrai PDB quand vous en avez un, car les structures dérivées d’une séquence ajoutent une source d’erreur supplémentaire.

diffdock prédit-il l’affinité ?

Non. DiffDock prédit des poses de liaison et un niveau de confiance, pas l’affinité de liaison. Si vous avez besoin d’un ordre de priorité de type affinité, associez diffdock à une étape de scoring ou de rescoring plutôt que de confondre confiance et puissance.

Le skill diffdock est-il adapté aux débutants ?

Oui, si votre tâche est simple : un récepteur, un ligand, une question de pose. Il devient plus difficile quand vous devez gérer une sélection par lot, des protéines flexibles ou une interprétation fine d’échantillons peu confiants. Le skill est accessible pour le docking, pas pour remplacer le jugement métier.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas diffdock comme base de décision pour des cibles où le changement conformationnel est le mécanisme principal de liaison, ou lorsque vous ne disposez que d’une représentation très incertaine du ligand. C’est aussi un mauvais substitut à un workflow complet d’analyse en chimie médicinale si votre vraie question porte sur la SAR, la sélectivité ou l’ADMET.

Comment améliorer le skill diffdock

Donner au skill un meilleur contexte moléculaire

Les meilleurs résultats de diffdock viennent généralement d’entrées propres : un fichier récepteur correct, un ligand avec une hypothèse de protonation connue et une définition claire du problème de liaison. Si le site est connu, dites-le. Si c’est une tâche de blind docking, dites-le aussi, car la stratégie de recherche et le niveau de confiance attendu ne sont pas les mêmes.

Demander la sortie que vous utiliserez vraiment

Améliorez l’usage de diffdock en précisant si vous voulez la meilleure pose, les 5 meilleures poses, un screening en lot ou des candidats classés par confiance. Si vous prévoyez de comparer les résultats plus tard, demandez un nommage de fichiers cohérent et un tableau récapitulatif. Cela réduit l’ambiguïté et facilite l’intégration des sorties dans une analyse pour Data Analysis ou un rapport de screening.

Surveiller les échecs les plus courants

Les erreurs les plus fréquentes consistent à traiter la confiance comme une affinité, à mal préparer le ligand et à trop faire confiance à des exécutions sur des protéines en dehors du domaine de confort du modèle. Si les résultats semblent instables, relancez avec davantage d’échantillons, comparez plusieurs poses de tête et vérifiez si le vrai blocage vient de la chimie du ligand ou de l’état de la protéine plutôt que du modèle.

Itérer avec des relances ciblées

Après le premier passage, améliorez le prompt diffdock suivant en indiquant le problème précis : mauvais placement du site, regroupement de poses incohérent ou scores de confiance faibles. C’est bien plus utile qu’une demande de relance générique. Quand vous avez besoin de diffdock pour Data Analysis, incluez la métrique que vous voulez extraire des sorties, par exemple la distribution des rangs, des seuils de score ou des résumés par complexe.