Les compétences de Neo.

Ce qu’est une compétence

Un dossier, un fichier SKILL.md, des instructions.

Une compétence (« skill ») tient dans un dossier. Son fichier SKILL.md donne un nom, une description, puis les instructions à suivre. Le dossier peut aussi contenir des documents de référence, des modèles et des scripts.

Neo garde en tête la liste de ses compétences, avec une description courte. Quand ta demande s’y prête, il ouvre la compétence et suit ses instructions ; il ne lit les fichiers annexes que s’il en a besoin. Tu n’as rien à faire pour qu’il s’en serve.

Fournies avec Neo

71 compétences, rangées par catégories : productivité, notes, e-mail, médias, création, recherche, maison connectée, développement… Par exemple :

google-workspace

Gmail, Agenda, Drive, Docs et Sheets.

himalaya

Lire et envoyer des e-mails (IMAP, SMTP).

maps

Adresses, lieux, itinéraires et fuseaux horaires, avec OpenStreetMap.

ocr-and-documents

Extraire le texte des PDF et des documents numérisés.

powerpoint

Créer, lire et modifier des présentations .pptx.

obsidian

Lire, chercher, créer et modifier tes notes Obsidian.

youtube-content

Des transcriptions de vidéos YouTube aux résumés.

blogwatcher

Suivre des blogs et des flux RSS ou Atom.

openhue

Piloter tes lampes Philips Hue : scènes, pièces.

apple-reminders

Les Rappels d’Apple (sur macOS seulement).

Où elles vivent

Dans ~/.neo/skills/, une par dossier, parfois rangées par catégorie : ~/.neo/skills/<catégorie>/<nom>/SKILL.md. On y trouve quatre origines :

Fournies

Copiées là par Neo et mises à jour avec lui. Si tu en modifies une, il garde ta version.

Officielles

Des compétences en option, publiées avec Neo, à installer quand tu en as besoin.

Installées

Venues d’un registre public, après analyse.

Les tiennes

Écrites par toi, ou par Neo lui-même.

Les lister

Toutes, avec leur origine et leur état.

Un tableau : nom, catégorie, origine, niveau de confiance, et si elle est activée. --source builtin, --source hub ou --source local filtre par origine ; --enabled-only ne garde que les compétences actives. Dans une conversation, au terminal : /skills list.

Activer, désactiver

Un menu, compétence par compétence ou par catégorie, partout ou pour une seule plateforme (le terminal, une messagerie). Une compétence désactivée disparaît de la liste que Neo garde en tête.

Pour lire une compétence, ouvre son SKILL.md : c’est un fichier texte.

Les utiliser

Le plus souvent, rien à faire : demande, Neo choisit.

Pour en imposer une, tape une barre oblique suivie de son nom, puis ta demande. Ça marche dans le terminal comme depuis ta messagerie :

Neo lit alors toute la compétence avant de répondre. Pour la garder chargée pendant toute une conversation, nomme-⁠la au lancement (plusieurs, séparées par des virgules) :

En installer

Chercher, lire, puis installer.

• neo skills search pdf

  Cherche dans les registres de compétences.

• neo skills browse

  Parcourt tout ce qui est disponible, page par page.

• neo skills inspect <identifiant>

  Montre une compétence sans l’installer : description, source, confiance, début du SKILL.md.

• neo skills install <identifiant>

  L’installe, après analyse et confirmation.

L’identifiant est celui que donne la recherche. Une compétence officielle en option, par exemple des fiches de révision :

L’adresse directe d’un fichier SKILL.md marche aussi.

L’analyse avant installation

Neo télécharge la compétence à part, puis l’analyse : envoi de données vers l’extérieur, commandes destructrices, code masqué, caractères invisibles… Le verdict (sûre, à surveiller, dangereuse) et la source décident de la suite :

Officielle

Fournie ou publiée avec Neo : installée.

De confiance

Quelques dépôts reconnus : installée, sauf si elle est jugée dangereuse.

Communauté

Tout le reste : installée seulement si elle est jugée sûre.

Dans le terminal, Neo te demande ensuite de confirmer. --force passe outre un verdict « à surveiller », jamais un verdict « dangereux ».

Les tenir à jour

• neo skills check

  Cherche des mises à jour pour les compétences installées depuis un registre.

• neo skills update

  Les met à jour, avec une nouvelle analyse.

• neo skills audit

  Analyse de nouveau ce qui est installé.

• neo skills uninstall <nom>

  Retire une compétence installée depuis un registre.

Une compétence installée sert à partir de la conversation suivante. Depuis une conversation (/skills install), ajoute --now pour t’en servir tout de suite.

En écrire une

Un dossier et un fichier texte suffisent.

1. Crée le dossier de la compétence :

   mkdir -p ~/.neo/skills/compte-rendu

2. Écris-⁠y un fichier SKILL.md : l’en-tête entre deux lignes ---, puis les instructions.

   ---
   name: compte-rendu
   description: Rédige le compte rendu d’une réunion à partir de notes en vrac.
   ---
   
   # Compte rendu de réunion
   
   Quand on te donne des notes de réunion :
   
   1. Commence par la date, les participants et l’objet.
   2. Regroupe les échanges par sujet, en phrases courtes.
   3. Termine par les décisions et les actions : qui, quoi, pour quand.

3. Ouvre une nouvelle conversation, ou tape /reload-skills dans celle en cours. Essaie-⁠la avec /compte-rendu, suivi de tes notes. Elle apparaît comme local dans neo skills list.

L’en-tête

name

Obligatoire, 64 caractères au plus ; de préférence en minuscules, chiffres et tirets. C’est aussi la commande /nom.

description

Obligatoire, 1 024 caractères au plus. Neo s’en sert pour décider d’ouvrir la compétence, et sa liste n’en garde que les 60 premiers caractères : mets l’essentiel au début.

platforms

Facultatif. Par exemple [macos] pour une compétence propre au Mac ; sans ce champ, partout.

version

Facultatif. Le numéro de ta compétence.

Les fichiers annexes

Dans le dossier de la compétence, quatre sous-dossiers sont reconnus : references/ (documents à lire au besoin), templates/ (modèles), scripts/ et assets/. Dans SKILL.md, ${NEO_SKILL_DIR} désigne le dossier de la compétence.

Quand Neo écrit ses compétences

Neo peut créer et corriger ses propres compétences, par exemple après une tâche difficile, pour la refaire mieux la fois suivante. Par défaut, il les enregistre sans attendre de relecture.