Créer des skills Rakenne avec le Skill Workshop

Les skills Rakenne sont des flux d’élaboration documentaire que l’agent peut exécuter lorsque les utilisateurs décrivent une tâche. Le Skill Workshop est un type de projet dédié qui permet de créer et publier ses propres skills en conversant avec l’agent — sans code. Ce tutoriel vous guide à travers le flux complet : de la création d’un projet workshop à la publication d’une skill dans la bibliothèque de votre organisation.

Ce dont vous avez besoin

• Accès à une instance Rakenne où vous pouvez créer des projets.
• Une idée claire d’un flux métier que vous voulez transformer en skill (ex. « rédiger des comptes-rendus à partir de transcriptions », « revue de contrats selon notre playbook », « construire une checklist conformité à partir du règlement X »).

Étape 1 : Créer un projet Skill Workshop

1. Dans Rakenne, lancez Créer un projet (ou équivalent dans votre interface).
2. Lors du choix du type de projet, sélectionnez Skill Workshop.
3. Donnez un nom au projet (ex. « Ma création de skills ») et créez-le.

L’espace de travail est provisionné avec :

• Skill skill-creator — Une skill intégrée dans .pi/skills/skill-creator/ qui guide le flux de création.
• AGENTS.md — Des instructions indiquant à l’agent qu’il s’agit d’un espace de création de skills et que les skills vont dans output/.
• output/ — Un répertoire vide où chaque skill créée résidera (un sous-répertoire par skill).

Vous utilisez le même espace de travail que d’habitude : chat avec l’agent, arborescence, aperçu des documents. La seule différence est le modèle et l’objectif : produire des skills au lieu d’un seul document.

Étape 2 : Démarrer la conversation de création

Ouvrez le projet et, dans le chat, décrivez ce que vous voulez construire. Par exemple :

• « Je veux créer une skill qui transforme les transcriptions de réunions en notes structurées avec décisions et actions. »
• « Nous avons besoin d’une skill qui aide à rédiger des analyses d’impact sur la vie privée en utilisant notre modèle interne et la PIPEDA. »

L’agent utilisera la skill skill-creator et ne créera aucun fichier tant qu’il n’aura pas compris votre flux. Il vous posera des questions de manière structurée (phase Elicit).

Étape 3 : Répondre aux questions d’élicitation

L’agent demandera :

1. À quoi sert le flux — Domaine et tâche (ex. notes de réunion, revue de contrats, conformité).
2. Ce qui le déclenche — Quand quelqu’un utiliserait cette skill (ex. « quand l’utilisateur a une transcription et veut des notes structurées »).
3. Les étapes impliquées — La séquence (ex. recevoir l’entrée → extraire décisions et actions → confirmer les ambiguïtés → produire le document).
4. À quoi ressemble la sortie — Type de document, sections, format (ex. résumé, journal des décisions, actions).
5. Connaissances métier — Règlements, normes, modèles ou documents de référence que l’agent doit utiliser.

Répondez en langage simple. L’agent transformera vos réponses en une skill structurée ; vous n’avez pas besoin de connaître le markdown ou le YAML. Si vous avez des modèles ou des docs de référence, vous pourrez les ajouter plus tard ou les décrire pour que l’agent puisse référencer des placeholders.

Étape 4 : Laisser l’agent échafauder et écrire la skill

Une fois que l’agent a assez d’informations, il va :

1. Choisir un slug — Un identifiant kebab-case (ex. meeting-notes, contract-review-playbook).
2. Appeler scaffold_skill — Cela crée output/{slug}/ avec un modèle SKILL.md et éventuellement les répertoires references/ et assets/.
3. Éditer SKILL.md — Il remplit les étapes du flux, les liens vers les fichiers de référence et le langage de déclenchement dans la description.
4. Ajouter les fichiers reference et asset — Les connaissances métier vont dans references/ ; les modèles ou exemples de sortie dans assets/.

Tout cela se fait dans le chat ; vous pouvez suivre l’arborescence et ouvrir les fichiers pour vérifier. Les skills sont uniquement écrites sous output/.

Étape 5 : Valider et affiner

Avant de considérer la skill comme prête, l’agent exécutera validate_skill. Cela vérifie :

• SKILL.md existe et a un frontmatter YAML valide (name, description).
• Qualité de la description — La description inclut un langage de déclenchement (ex. « Use when… », « Use for… »).
• Longueur du corps — Corps de SKILL.md sous 500 lignes (le contenu long doit aller dans references/).
• Intégrité des références — Les liens dans SKILL.md pointent vers des fichiers existants ; pas de liens cassés.
• metadata.json — Présent et valide (ou avertissement s’il manque ; vous l’ajouterez à l’étape suivante).

Si quelque chose échoue, l’agent proposera des corrections (ex. ajouter le langage de déclenchement, corriger un chemin, déplacer du contenu vers un fichier de référence). Vous pouvez affiner dans le chat et re-valider jusqu’à ce que tous les contrôles passent.

Étape 6 : Préparer les métadonnées pour la bibliothèque

Quand vous êtes satisfait du contenu de la skill, l’agent préparera la publication :

1. Exécuter preview_metadata — Affiche comment la skill apparaîtra dans la bibliothèque. Si metadata.json n’existe pas, un brouillon est généré à partir du frontmatter de SKILL.md.
2. Éditer metadata.json — Ensemble vous définirez title (nom lisible pour la bibliothèque), description (résumé court), tags (noms communs anglais orientés domaine, ex. « Productivity », « Meetings », « Legal », « Compliance ») et examples (deux ou trois exemples de prompts).
3. Valider à nouveau — Un dernier validate_skill assure que métadonnées et structure sont complètes.

Ensuite, l’agent vous indiquera que la skill est prête à être publiée.

Étape 7 : Publier dans votre bibliothèque

1. Dans la barre d’outils du projet, cliquez sur Publish Skill.
2. Une boîte de dialogue liste les skills dans votre répertoire output/ (chaque dossier contenant un SKILL.md). Sélectionnez la skill à publier.
3. Confirmez. Le frontend appelle l’API de publication ; la skill est copiée dans la bibliothèque de skills de votre organisation et enregistrée dans le catalogue.
4. Vous verrez un message de succès (ex. « Skill publiée dans la bibliothèque »). La skill est disponible lors de l’installation de skills sur tout projet de votre tenant. Republier le même slug met à jour la skill existante.

Anatomie d’une skill Rakenne

Une skill minimale dans output/{slug}/ ressemble à ceci :

• SKILL.md — Requis. Frontmatter YAML avec name (slug) et description (incluant le langage de déclenchement). Corps : étapes du flux, règles et liens vers les références.
• metadata.json — Requis pour la publication. title, description, tags (tableau), examples (tableau de prompts d’exemple). Utilisé par l’interface de la bibliothèque.
• references/ — Optionnel. Fichiers Markdown (ou autres) avec les connaissances métier ; liés depuis SKILL.md pour que l’agent puisse les lire pendant le flux.
• assets/ — Optionnel. Modèles ou assets statiques que l’agent utilise pour produire la sortie (ex. meeting_notes_template.md).

Le flux skill-creator garde SKILL.md concis et déplace le contenu détaillé dans references/ pour que l’agent ait un flux clair et scannable plus un contexte riche quand il le faut.

Conseils

• Un flux par skill — Si vous avez plusieurs flux distincts, créez une skill par flux ; vous pouvez créer plusieurs skills dans le même projet workshop (chacune dans son output/{slug}/).
• Le langage de déclenchement compte — L’agent utilise la description de la skill pour décider quand l’activer. Des phrases comme « Use when the user wants to… », « Use for drafting… » ou « Use to generate… » aident à faire correspondre l’intention.
• Itérer dans le workshop — Vous pouvez rouvrir le projet à tout moment, éditer les fichiers ou discuter avec l’agent pour modifier la skill, re-valider et Publish Skill à nouveau pour mettre à jour la copie en bibliothèque.
• Pas d’extension.ts pour les skills métier — Le Skill Workshop est pour les skills basées markdown (SKILL.md + references + assets). Les extensions TypeScript sont hors périmètre du flux guidé ; le skill-creator ne crée ni n’édite extension.ts.

Prochaines étapes

• Utilisez Session Management and Context Hygiene pour garder chaque tâche de création dans une session focalisée.
• Lisez Rakenne 0.2.0 — Skill Workshop et plus pour l’ensemble des fonctionnalités et les améliorations de la bibliothèque.
• Après publication, installez votre skill sur un projet d’élaboration documentaire et exécutez quelques prompts d’exemple pour confirmer le comportement attendu.