diffdock

Panorama general de la skill diffdock

Para qué sirve diffdock

DiffDock es una skill centrada en docking para predecir poses de unión proteína-ligando a partir de una estructura o secuencia de proteína y una entrada de ligando. Usa la skill diffdock cuando necesites una respuesta práctica a “¿dónde y cómo podría unirse este compuesto?” en lugar de una estimación de afinidad de unión.

Mejor encaje y límite de decisión

Encaja bien en diseño de fármacos basado en estructura, virtual screening y generación de poses para análisis posteriores. Es una opción menos adecuada si solo necesitas ordenar compuestos por potencia, si tu proteína diana es muy flexible o si quieres un flujo de trabajo de química genérico en lugar de un flujo de trabajo de predicción de poses.

Qué la hace útil

Su valor principal es que diffdock combina docking de un solo complejo, screening por lotes, puntuación de confianza e ইনput de proteína basado en secuencia en un solo flujo de trabajo. Eso hace que instalar diffdock merezca la pena cuando quieres tanto una ruta de docking ejecutable como suficiente orientación para no interpretar mal las puntuaciones.

Cómo usar la skill diffdock

Instala e inspecciona el flujo de trabajo

Instala la skill diffdock en tu configuración de Claude skills y luego abre primero SKILL.md. Después, lee references/workflows_examples.md, references/parameters_reference.md y references/confidence_and_limitations.md para entender de verdad las formas de entrada, los valores predeterminados y cómo interpretar las puntuaciones antes de ejecutar un trabajo.

Convierte tu tarea en un prompt utilizable

Para usar diffdock, indica desde el principio el formato de la proteína, el formato del ligando y el tipo de trabajo. Una buena entrada es específica, por ejemplo: “Dock this SMILES to this PDB and return the top 5 poses with confidence interpretation,” o “Prepare batch docking for these ligands against one receptor.” Una entrada débil es solo “run diffdock”, porque oculta si la skill debe usar un archivo, una secuencia o un lote CSV.

Usa los archivos y salidas correctos

Para docking individual, empieza con un PDB de proteína y un ligando en SMILES, SDF o MOL2. Para trabajo por lotes, usa la plantilla CSV en assets/batch_template.csv y revisa scripts/prepare_batch_csv.py si necesitas validación antes de la ejecución. Después de una ejecución, scripts/analyze_results.py ayuda a resumir el ranking de poses y las puntuaciones de confianza, para que no tengas que inspeccionar manualmente cada archivo de salida.

Consejos prácticos de configuración

La instalación de DiffDock y la primera ejecución pueden ralentizarse por los pesos del modelo y la generación de tablas de consulta, así que planifica ese coste de puesta en marcha. Si tu proteína no está disponible como estructura, la skill admite plegado basado en secuencia, pero eso añade incertidumbre; úsalo cuando no exista una estructura experimental, no como atajo por defecto. Ajusta el muestreo solo cuando la tarea sea difícil, porque más muestras mejoran la cobertura de búsqueda, pero también aumentan el cómputo y el trabajo de posprocesado.

Preguntas frecuentes sobre la skill diffdock

¿diffdock es solo para archivos PDB?

No. La skill diffdock admite estructuras de proteína y, en algunos flujos de trabajo, secuencias de proteína que se pliegan antes del docking. Aun así, lo mejor es usar un PDB real cuando lo tengas, porque las estructuras derivadas de secuencia añaden otra fuente de error.

¿diffdock predice afinidad?

No. DiffDock predice poses de unión y confianza, no afinidad de unión. Si necesitas una priorización similar a afinidad, combina diffdock con una etapa de scoring o rescoring en lugar de tratar la confianza como si fuera potencia.

¿La skill diffdock es apta para principiantes?

Sí, si tu tarea es sencilla: un receptor, un ligando y una pregunta de pose. Se complica cuando necesitas curación por lotes, proteínas flexibles o interpretar con cuidado muestras de baja confianza. La skill es apta para principiantes en docking, no para sustituir el criterio experto de dominio.

¿Cuándo no debería usarla?

No confíes en diffdock para dianas en las que el cambio conformacional sea el mecanismo principal de unión, ni cuando solo tengas una representación del ligando muy incierta. Tampoco sustituye bien un flujo completo de análisis de química medicinal si tu pregunta real es SAR, selectividad o ADMET.

Cómo mejorar la skill diffdock

Dale mejor contexto molecular a la skill

Los mejores resultados de diffdock suelen venir de entradas limpias: un archivo receptor correcto, un ligando con una hipótesis clara de protonación y una definición precisa del problema de unión. Si el sitio se conoce, dilo. Si es una tarea de blind docking, dilo también, porque la estrategia de búsqueda y la confianza esperada cambian.

Pide la salida que de verdad vas a usar

Mejora el uso de diffdock especificando si quieres la mejor pose, las 5 mejores poses, screening por lotes o candidatos ordenados por confianza. Si piensas comparar resultados después, pide nombres de archivo coherentes y una tabla resumen. Esto reduce la ambigüedad y hace que la salida sea más fácil de integrar en análisis de Data Analysis o en informes de screening.

Vigila los modos de fallo comunes

Los errores más habituales son tratar la confianza como afinidad, preparar mal el ligando y sobreconfiar en ejecuciones sobre proteínas fuera de la zona de confort del modelo. Si los resultados parecen inestables, vuelve a ejecutar con más muestras, compara varias poses principales e inspecciona si el bloqueo real está en la química del ligando o en el estado de la proteína, no en el modelo.

Itera con prompts de seguimiento específicos

Después de la primera ejecución, mejora el siguiente prompt de diffdock con el problema concreto: mala colocación del sitio, agrupamiento inconsistente de poses o puntuaciones de confianza bajas. Eso es mucho más útil que pedir una nueva ejecución genérica. Cuando necesites diffdock para Data Analysis, incluye la métrica que quieres extraer de las salidas, como distribución de rangos, umbrales de puntuación o resúmenes por complejo.