creating-skills

Par microsoft · fluidframework

À utiliser pour créer un nouveau skill personnalisé dans un profil — guide la collecte des exigences, la création de la structure de répertoires, la rédaction du fichier SKILL.md, et l'ajout optionnel de scripts intégrés

npx skills add https://github.com/microsoft/fluidframework --skill creating-skills

<required> CRITIQUE Ajoutez les étapes suivantes à votre liste Todo avec TodoWrite :

  1. Recueillez les exigences de compétences auprès de moi
  2. Sélectionnez le profil cible
  3. Créez la structure du répertoire de compétences
  4. Écrivez SKILL.md avec le frontmatter approprié
  5. (Optionnel) Écrivez et regroupez les scripts
  6. Demandez à l'utilisateur d'exécuter /nori-switch-profile pour changer de profil. </required>

Aperçu

Cette compétence vous guide à travers la création de compétences personnalisées qui persistent entre les sessions. Les compétences sont stockées dans des répertoires de profil et peuvent inclure des instructions markdown, des listes de contrôle et des scripts optionnels regroupés.

Écriture de compétences

Chaque compétence doit commencer par un bloc de liste de contrôle obligatoire :

<required>
*CRITIQUE* Ajoutez les étapes suivantes à votre liste Todo avec TodoWrite :
1. <étape 1>
2. <étape 2>
...
</required>

C'est la partie la plus importante d'une compétence.

Chaque étape peut avoir des directives en dessous. Par exemple :

1. Créez un répertoire.

Utilisez `mkdir foo/bar`

2. Créez un fichier.

...

Écriture de scripts

Les compétences peuvent être regroupées avec des scripts. Les scripts sont des outils CLI de code simples qui effectuent diverses opérations de manière déterministe.

Tous les scripts que vous écrivez doivent être entièrement autonomes. Demandez à l'utilisateur quel langage il préfère.

Les scripts doivent être appelables à partir de l'outil Bash.

Le script doit être stocké au même endroit que la compétence. Ajoutez une section à SKILL.md sur la façon d'utiliser le script. Si l'appel du script est obligatoire, ajoutez cette instruction au bloc <required>.

Outils et Code

Documentez les outils nécessaires pour la compétence.

Le SKILL doit explicitement encourager l'écriture de code. L'agent doit être invité à écrire du code pour appeler un outil chaque fois que l'agent doit appeler des outils plus d'une fois. L'agent doit écrire du code au lieu d'appeler les outils lui-même.

Les étapes qui font référence à des outils et des API doivent les intégrer dans le processus étape par étape.

<good-example>

  • Écrivez un script Python qui utilise l'API Slack pour récupérer mes messages non lus. Le script doit écrire mes messages dans un dossier, /home/foobar/daily-analysis/<DD-MM-YYYY>/slack
  • Écrivez un script Python qui utilise l'API Gmail pour récupérer ma boîte de réception. Le script doit écrire mes emails dans un dossier, /home/foobar/daily-analysis/<DD-MM-YYYY>/email
  • Écrivez un script Python pour identifier les messages les plus urgents auxquels je dois répondre. <system-reminder> Les identifiants d'authentification se trouvent à /home/foobar/authentication/auth.txt </system-reminder> </good-example>

<bad-example> Outils : Slack, Gmail API

  • Résumez mes messages en examinant les surfaces courantes que je peux utiliser pour les messages. </bad-example>

<good-example> Consultez https://raw.githubusercontent.com/tilework-tech/nori-skillsets/96012bcfcd9482b248debed7b9a7fc7c345f76e1/src/cli/features/claude-code/profiles/config/amol/skills/finishing-a-development-branch/SKILL.md </good-example>

<good-example> Consultez https://raw.githubusercontent.com/tilework-tech/nori-skillsets/96012bcfcd9482b248debed7b9a7fc7c345f76e1/src/cli/features/claude-code/profiles/config/amol/skills/webapp-testing/SKILL.md </good-example>

Skills similaires