Que sont les compétences d'agent Substreams ?
Mis à jour en août 2026
Les compétences d'agent Substreams sont cinq packages de connaissances open source qui donnent aux assistants de codage IA une réelle expertise dans la construction de projets Substreams. Elles couvrent les manifestes, les patterns de modules Rust, la conception de schémas protobuf, les schémas de sink SQL, le déploiement en production et les tests.
Elles sont publiées par StreamingFast sous licence Apache 2.0 sur github.com/streamingfast/substreams-skills, et fonctionnent dans Claude Code, Cursor et VS Code.
Pourquoi les assistants ont-ils besoin d'une compétence ?
Un assistant de codage généraliste connaît Rust. Il ne connaît pas les conventions de Substreams — comment un manifeste substreams.yaml est structuré, quand utiliser un module map plutôt qu'un module store, comment les schémas protobuf correspondent aux sorties de module, ou quelles versions de crate fonctionnent réellement ensemble sur la chaîne d'outils actuelle.
Sans cette connaissance, il produit du code plausible qui ne compile pas. Les compétences apportent l'expertise métier manquante, y compris les pièges précis qui font perdre le plus de temps.
Que couvre chacune d'elles ?
| Compétence | Portée |
|---|---|
substreams-dev | Manifestes, modules map/store/index, conception de schémas protobuf, optimisation des performances, débogage |
substreams-sql | Database changes (CDC), mappings relationnels, stratégies d'indexation PostgreSQL, vues matérialisées et patterns de séries temporelles ClickHouse |
substreams-sink | Consommer la sortie Substreams en Go, JavaScript, Python ou Rust — gestion du curseur, gestion des réorganisations de chaîne, streaming gRPC |
substreams-sink-deploy | Exécuter des binaires de sink en production — sélection du sink, formats de DSN, rattrapage d'historique et suivi en direct, supervision, sécurité au redémarrage |
substreams-testing | Tests unitaires et d'intégration avec de vraies données blockchain, benchmarking de performance, pipelines CI/CD |
Installer substreams-dev récupère les cinq.
Sont-elles bonnes ?
Elles ont été évaluées publiquement plutôt que simplement décrites. Dans un test publié, un agent utilisant ces compétences a construit 14 projets Substreams à partir de prompts en anglais simple sur Ethereum et Solana : 100 % construits, 100 % exécutés, et 12 sur 14 correspondant à une référence octet pour octet.
Le même document consigne les modes d'échec — prompts vagues, tokens ERC-20 non standards, nommage incohérent des champs proto quand aucun schéma n'est spécifié. Le dépôt fournit aussi 16 exemples travaillés, dont deux mises en garde délibérées.
Comment les installer ?
Pour Claude Code, ajoutez le marketplace et installez le plugin — claude plugin marketplace add streamingfast/substreams-skills, puis claude plugin install substreams-dev@streamingfast-substreams. Lancez /skills pour confirmer que les cinq apparaissent. Pour Cursor, clonez le dépôt et ajoutez le chemin du répertoire de compétences dans les réglages. VS Code 1.107+ les prend en charge en tant que fonctionnalité expérimentale.
Les instructions d'installation complètes pour chaque éditeur se trouvent dans le répertoire guides/ du dépôt.
Puis-je y contribuer ?
Oui. Le dépôt est open source et inclut un guide SKILL_DEVELOPMENT.md pour ajouter de nouvelles compétences, ainsi qu'un script de validation que vous pouvez exécuter sur les vôtres.
Questions fréquentes
Sous quelle licence sont les compétences ? Apache 2.0, la même que Firehose et Substreams eux-mêmes.
Fonctionnent-elles avec des assistants autres que Claude ? Elles sont documentées pour Claude Code, Cursor et VS Code. Comme ce sont des packages de connaissances markdown open source, elles peuvent être adaptées à d'autres assistants.
Ai-je besoin des compétences pour utiliser Substreams ? Non. Elles vous aident à construire des packages plus vite, mais vous pouvez réutiliser des packages du registre ou écrire des modules à la main sans elles.
Installez depuis github.com/streamingfast/substreams-skills, et obtenez une clé API sur thegraph.market — aucune information personnelle requise.
Voir aussi : Puis-je construire un package Substreams sans connaître Rust ? · Comment construire un indexeur blockchain avec un assistant de codage IA ? · Quelle est la fiabilité du code d'indexation blockchain généré par IA ?