GDM Science Bundle (vendored)
Une copie vendorisée du bundle google-deepmind/science-skills
(pin : voir UPSTREAM_PIN.txt). Ce répertoire est le fallback de long tail :
pour les 5 sous-plugins avec support first-class zorai (alphagenome, alphafold,
uniprot, clinvar, chembl) préférez le sous-plugin correspondant plugins/zorai-plugin-science/
pour les paramètres typés et les réponses structurées. Pour tous les autres
sous-skills de ce bundle, suivez le workflow ci-dessous.
Comment utiliser un sous-skill dans ce bundle
- Lisez d'abord le fichier
SKILL.mddu skill. Structure :skills/<skill_dir>/SKILL.md— le frontmatter YAML du fichier est le contrat de routage ; le corps markdown est le workflow complet avec étapes, corrections d'erreurs, et modèles de rapport. Ne sautez jamais cette lecture. - Invoquez Python uniquement via
uv run. Les scripts DeepMind utilisent des blocs# /// script ... # ///inline PEP 723, doncuv runrésoudra et installera les bonnes dépendances dans un cache isolé (~/.cache/uv/). N'utilisez jamaispython3bare oupip install. - Lisez les Prerequisites de chaque skill avant de l'exécuter. La plupart des skills ont besoin de
uvsur PATH (le runtime zorai l'a), un fichier~/.envavec la clé API pertinente, et possiblement une étape de notification qui enregistre l'utilisation du skill. - Ne lisez jamais, ne faites pas
cat,echo,printenv, nios.environ.getsur le fichier.envou ses clés. Les scripts DeepMind chargent les credentials viadotenvà l'intérieur du script — ils tirent les clés du disque mais ne les exposent pas au contexte de l'agent. Gardez-le ainsi. - Lors de l'exécution dans le sandbox zorai, l'injection de credentials est gérée par
le système de paramètres du plugin (voir les sous-plugins
zorai_plugin_science) ; pour les long-tail skills ici, utilisez le chargement normal sur disque dedotenv.
Inventaire des sous-skills dans ce bundle
| Sous-skill (kebab-case) | Chemin sous ce bundle | Notes |
|---|---|---|
alphafold-database-fetch-and-analyze |
skills/alphafold_database_fetch_and_analyze/ |
Compute, a aussi un sous-plugin zorai. |
alphagenome-single-variant-analysis |
skills/alphagenome_single_variant_analysis/ |
Compute + clé API, a aussi un sous-plugin zorai. |
chembl-database |
skills/chembl_database/ |
REST, a aussi un sous-plugin zorai. |
clinical-trials-database |
skills/clinical_trials_database/ |
REST. |
clinvar-database |
skills/clinvar_database/ |
REST, a aussi un sous-plugin zorai. |
dbsnp-database |
skills/dbsnp_database/ |
REST (NCBI EFetch). |
embl-ebi-ols |
skills/embl_ebi_ols/ |
REST (OLS4). |
encode-ccres-database |
skills/encode_ccres_database/ |
REST. |
ensembl-database |
skills/ensembl_database/ |
REST. |
foldseek-structural-search |
skills/foldseek_structural_search/ |
Compute (binaire Foldseek). |
gnomad-database |
skills/gnomad_database/ |
REST. |
gtex-database |
skills/gtex_database/ |
REST. |
human-protein-atlas-database |
skills/human_protein_atlas_database/ |
REST. |
interpro-database |
skills/interpro_database/ |
REST. |
jaspar-database |
skills/jaspar_database/ |
REST. |
literature-search-arxiv |
skills/literature_search_arxiv/ |
REST. |
literature-search-biorxiv |
skills/literature_search_biorxiv/ |
REST. |
literature-search-europepmc |
skills/literature_search_europepmc/ |
REST. |
literature-search-openalex |
skills/literature_search_openalex/ |
REST (clé optionnelle). |
ncbi-sequence-fetch |
skills/ncbi_sequence_fetch/ |
REST (EFetch). |
openfda-database |
skills/openfda_database/ |
REST. |
opentargets-database |
skills/opentargets_database/ |
REST (GraphQL). |
pdb-database |
skills/pdb_database/ |
REST. |
protein-sequence-msa |
skills/protein_sequence_msa/ |
Compute. |
protein-sequence-similarity-search |
skills/protein_sequence_similarity_search/ |
Compute. |
pubchem-database |
skills/pubchem_database/ |
REST. |
pubmed-database |
skills/pubmed_database/ |
REST. |
pymol |
skills/pymol/ |
Compute (binaire PyMOL). |
quickgo-database |
skills/quickgo_database/ |
REST. |
reactome-database |
skills/reactome_database/ |
REST. |
string-database |
skills/string_database/ |
REST. |
ucsc-conservation-and-tfbs |
skills/ucsc_conservation_and_tfbs/ |
REST. |
unibind-database |
skills/unibind_database/ |
REST. |
uniprot-database |
skills/uniprot_database/ |
REST, a aussi un sous-plugin zorai. |
uv |
skills/uv/ |
Interne. Configure uv. Le runtime zorai le fournit déjà. |
scienceskillscommon |
skills/scienceskillscommon/ |
Interne. Helpers partagés pour les autres skills. Ne l'invoquez pas directement. |
workflow-skill-creator |
skills/workflow_skill_creator/ |
Meta-skill. À ignorer ; l'agent n'a pas besoin d'écrire de nouveaux skills en cours de tâche. |
Règles de runtime partagées
- Tous les scripts s'attendent à être exécutés depuis le répertoire du skill (ou avec
--project $SKILL_DIRpour les appels ad-hoc). LeSKILL.mddu skill vous le dira. - Les artefacts de sortie doivent aller sous le répertoire de travail de l'utilisateur (ou le chemin que l'utilisateur spécifie). Ne polluez pas
skills/. - Confirmez avec l'utilisateur avant d'invoquer quoi que ce soit avec un coût réel ou une limite de débit (appels API AlphaGenome, pulls en masse OpenAlex, requêtes serveur Foldseek, etc.).
- Si le
SKILL.mdd'un sous-skill dit d'enregistrer unLICENSE_NOTIFICATION.txtdans le répertoire du skill, sautez l'écriture du fichier lors de l'exécution via zorai (le bundle est en lecture seule dans le repo) ; mentionnez plutôt l'URL de licence upstream à l'utilisateur une fois par session.
Licence & attribution
- Code dans ce bundle — Apache License 2.0 (voir
LICENSE). - Documentation dans ce bundle — Creative Commons Attribution 4.0 International (CC-BY-4.0).
- Les fournisseurs de base de données individuels ont leurs propres conditions. Voir
SKILL_LICENSES.mdpour la liste complète. Vous êtes responsable de vous assurer que toute donnée récupérée via ces skills est utilisée en conformité avec les conditions du fournisseur upstream. - Repo upstream : https://github.com/google-deepmind/science-skills
- Pin : voir
UPSTREAM_PIN.txtpour le hash de commit exact auquel ce bundle a été vendorisé. Pour actualiser, re-vendorisez à un commit plus récent et mettez à jour le pin.