# Ajouter votre propre compétence

> Installez une compétence que vous avez écrite, depuis un dépôt Git public ou privé ou un paquet Python, dans un ensemble de compétences en quelques clics.

Source: https://docs.thalovant.com/fr/manage/add-your-own-skill/

---
{/* Last Edit: Claude Opus 5.5 - 2026-09-28 - Motive: Canadian French translation of manage/add-your-own-skill.mdx. */}

Vous pouvez faire tourner vos propres compétences à côté de celles du Skill Store. Donnez à Thalovant l'adresse de votre dépôt de code ou le nom de votre paquet Python publié, puis choisissez l'ensemble de compétences qui doit l'exécuter.

Si vous n'avez pas encore écrit de compétence, commencez par le [tutoriel Pocket Quiz](/fr/developers/skillkit-tutorial/). Il vous mène d'un dossier vide à une compétence testée, en anglais et en français.

Cette page sert à faire tourner, sur vos propres hubs, une compétence que vous avez écrite. Commencez dans Skills → Skill Store → **Manage custom skills**, ou **Add custom skill**. C'est terminé quand votre compétence s'affiche comme installée, que l'ensemble de compétences est en bonne santé et que le hub répond.

## Ce qu'il faut d'abord à votre compétence

Vérifiez les points suivants :

- votre compétence s'installe avec `pip`, et ses tests et ses [vérifications de paquet](/fr/developers/writing-a-skill/#vérifier-ce-que-vous-avez-construit) passent;
- son code se trouve dans un dépôt Git que le hub peut lire, ou son paquet est publié dans un index de paquets que le hub peut utiliser;
- l'ensemble de compétences (et le hub) où vous voulez la mettre existe déjà;
- les compétences privées exigent un forfait d'espace de travail qui inclut les ensembles de compétences privés.

Un dossier sur votre ordinateur n'est pas une source d'installation pour le hub. Pour le tutoriel, placez le projet terminé dans votre propre dépôt Git et gardez le commit ou l'étiquette (tag) exacts que vous avez testés. Une étiquette est un nom que vous donnez à une version enregistrée, comme `v0.1.0`.

Chaque hub qui utilise l'ensemble de compétences choisi reçoit cette compétence. Utilisez un ensemble de compétences de test distinct pour essayer votre première version.

## Ajouter la compétence

1. Ouvrez **Skills** et sélectionnez l'ensemble de compétences qui doit faire tourner votre compétence.
2. Ouvrez l'onglet **Skill Store** et choisissez **Manage custom skills** ou **Add custom skill**.
3. Remplissez **Skill id** et **Display name**. Pour le tutoriel, utilisez `thalovant-skill-pocket-quiz` et `Pocket Quiz`.
4. Ouvrez **Source** et collez l'URL de votre dépôt ou le nom de votre paquet. Pour Git, entrez l'étiquette ou le commit testé dans **Branch, tag, or version**. Pour un paquet Python, entrez la **Version** testée.
5. Pour un **dépôt privé**, ajoutez un jeton d'accès en lecture seule dans les champs d'accès Git. Il est stocké de façon sécurisée, sert uniquement à l'installation et n'est plus jamais affiché.
6. Choisissez **Create and install**. Ouvrez **Installed** et suivez la ligne jusqu'à ce qu'elle affiche **installed**. L'installation s'applique normalement pendant que le runtime continue de tourner.
7. Dites à votre hub l'une des phrases d'exemple de la compétence. Pour le tutoriel, dites « start pocket quiz », puis répondez à sa question.

Les compétences personnalisées restent privées à votre espace de travail. Elles s'installent dans le seul ensemble de compétences que vous avez choisi et utilisent les limites de votre forfait actuel. Il n'y a pas d'abonnement distinct.

## Mettre à jour votre compétence

Testez d'abord le code modifié, puis publiez une nouvelle étiquette Git ou une nouvelle version du paquet Python. Pousser du code, à lui seul, ne met pas à jour une installation épinglée.

1. Ouvrez **Installed** pour l'ensemble de compétences à mettre à jour.
2. Ouvrez le menu d'actions de la compétence et choisissez **Edit custom skill**.
3. Ouvrez **Source**, entrez la nouvelle étiquette, le nouveau commit ou la nouvelle version du paquet, et choisissez **Save changes**.
4. Suivez l'état de l'installation, puis posez au hub une question qui met votre changement à l'épreuve. Recommencez pour chaque autre ensemble de compétences à mettre à jour.

Les mises à jour s'appliquent normalement pendant que le runtime continue de tourner.
Attendez l'état installé et testez la réponse : enregistrer le formulaire ne prouve
pas, à lui seul, que le nouveau code est prêt.

## En cas d'échec

- Lisez l'erreur sur la ligne de la compétence. Vérifiez l'adresse de la source, la version demandée et les dépendances du paquet.
- Corrigez le code, testez-le, publiez une nouvelle version et mettez la source à jour comme ci-dessus.
- Une installation depuis un dépôt privé qui ne peut pas s'authentifier le signale clairement : vérifiez le jeton d'accès Git dans l'ensemble de compétences.

## Votre compétence est prête quand

- la compétence affiche **installed** dans l'ensemble de compétences;
- l'ensemble de compétences est en bonne santé;
- votre hub répond aux intentions de la compétence;
- la réponse correspond à la version que vous avez testée, y compris ses langues prises en charge.

## Étape suivante

Consultez [Écrire une compétence](/fr/developers/writing-a-skill/) quand vous voulez ajouter d'autres comportements, et [Les compétences](/fr/concepts/skill-sets/) pour comprendre comment les ensembles de compétences partagent des compétences entre les hubs. Pour distribuer un wheel construit par le catalogue, consultez [Publier une version de votre compétence](/fr/manage/add-a-skill-to-a-hub/#publier-une-version-de-votre-compétence).
