Transformer un document en skill

Tutoriel · 6 min de lecture

Le savoir que vous voulez transmettre à un agent est généralement déjà écrit quelque part — un PDF d'intégration, une charte rédactionnelle dans Word, un guide d'intervention en Markdown. Ce qui manque, ce n'est pas le savoir. C'est qu'un document est écrit pour une personne qui le lit du début à la fin, alors qu'un skill doit fonctionner pour un agent qui la charge en cours de tâche et doit agir.

Skilnu peut faire la première passe de cette conversion. Importez un document et vous récupérez un brouillon de SKILL.md — le modèle mental central, les définitions, les consignes, restructurés en instructions. Rien n'est publié. Vous le relisez, corrigez ce qui ne va pas, et publiez quand vous êtes satisfait, comme pour n'importe quel autre skill.

1. Importez le document

Dans l'application, ouvrez + New skill puis cliquez sur Draft from a document, à côté de « Importer SKILL.md ». Choisissez votre fichier et patientez — c'est plus long que le reste de l'application, car il faut lire puis réécrire tout un document.

Ces formats fonctionnent : .pdf, .docx, .txt, .md, .markdown, .rst et .adoc.

Tout le reste est refusé avant même l'import. Si votre format n'est pas dans cette liste, exportez-le d'abord en PDF — cette voie est bien prise en charge.

2. Envoyez une section, pas une bibliothèque

La limite est d'environ 40 000 caractères de texte extrait, soit à peu près un long chapitre. Au-delà, l'import est refusé plutôt que discrètement tronqué — un skill rédigé à partir des 40 000 premiers caractères d'un livre de 300 pages, présentée comme rédigée à partir du livre, serait pire qu'une erreur.

C'est moins contraignant qu'il n'y paraît, car ce qui fait un bon skill est précisément ce qui tient dans la limite : un sujet cohérent. « Nos standards de revue de code » est un skill. « Tout le manuel d'ingénierie » en est un dossier entier. Si votre document est volumineux, découpez-le par chapitre et rédigez chaque skill séparément — vous obtiendrez de meilleures skills que ce qu'une passe unique aurait produit de toute façon.

3. Les PDF scannés doivent d'abord passer par l'OCR

Un PDF qui n'est en réalité qu'une suite de photographies de pages ne contient aucun texte à extraire ; le brouillon revient donc avec un message l'expliquant plutôt qu'avec un skill vide. Passez-le d'abord dans n'importe quel outil d'OCR — la plupart des applications PDF proposent « reconnaître le texte » — puis importez la version consultable.

Un test rapide : ouvrez le PDF et essayez de sélectionner une phrase. Si vous n'y arrivez pas, c'est une image.

4. Relisez sérieusement le brouillon

Le brouillon arrive dans le formulaire de composition, avec le nom et la description remplis à partir de son propre frontmatter. C'est une première passe réalisée par un modèle qui a lu votre document une fois : lisez-le comme vous liriez le premier jet d'un collègue compétent, et non comme un travail achevé.

Trois points méritent une vérification à chaque fois :

A-t-il conservé les détails concrets ? Commands, thresholds, names of internal tools, the actual numbers. These are the most useful part of a skill and the easiest thing to lose when prose gets condensed.

A-t-il inventé quelque chose ? The draft is told to stay inside what the document supports, but if your document was vague somewhere, check that the draft was vague in the same place rather than confidently filling the gap.

Est-ce des instructions, ou un résumé ? The failure mode to watch for is a draft that describes what the document says instead of telling the agent what to do. If a section reads like a book report, rewrite it as a rule.

5. Publiez-le

Modifiez le formulaire jusqu'à être satisfait, puis publiez normalement. À partir de là, c'est un skill ordinaire : il peut être versionné, servir de dépendance à d'autres skills, être partagé avec votre équipe et ajouté à votre bibliothèque MCP.

Le faire depuis un agent

Le même parcours est disponible via MCP, sous forme de deux outils, car le fichier doit rejoindre le stockage entre les deux. Demandez une URL d'import, envoyez les octets, puis demandez le brouillon :

get_document_upload_url(filename="handbook.pdf")
  -> { upload_url, document_key }

PUT the file's bytes to upload_url
  (no auth header -- the URL is already signed)

draft_skill_from_document(document_key=...)
  -> { name, description, skill_md }

La version agent accepte un argument instructions supplémentaire que le formulaire web n'expose pas, et il est réellement utile ici — « concentre-toi sur le chapitre 3 », « écris pour quelqu'un qui découvre le sujet », « conserve tous les exemples de code ». Il s'ajoute à vos instructions de compilation permanentes au lieu de les remplacer.

Comme partout ailleurs, draft_skill_from_document se contente de rédiger un brouillon. La publication reste un appel publish_skill distinct : un agent ne peut donc pas transformer un document en skill publié sans que vous ayez d'abord vu le brouillon.

Ce que cela coûte

Chaque brouillon consomme une unité de votre quota de compilation quotidien, sur le modèle choisi dans les Paramètres — le même budget que la publication avec compilation. Un brouillon en échec qui n'a jamais atteint le modèle, comme un fichier non pris en charge ou trop long, ne consomme rien.

Votre document importé est un espace temporaire. Il est supprimé dès que le brouillon est généré, succès ou échec, et tout ce qui y survivrait malgré tout disparaît sous 24 heures. Il ne fait jamais partie du skill publié — seul le brouillon que vous relisez en fait partie.

À quoi cela sert le mieux

Les meilleurs candidats sont les documents qui encodent déjà une façon de travailler : une charte rédactionnelle, une check-list de revue, un guide d'intervention, le chapitre d'un ouvrage technique que vous voulez voir appliqué plutôt que cité. Une documentation de référence sans procédure — un export d'API, un glossaire, un tableur exporté en PDF — donnera un skill maigre, faute de consignes à en extraire.

Un bon test avant d'importer : quelqu'un pourrait-il lire ce document puis faire quelque chose différemment ? Si oui, cela fera un skill. Si c'est seulement un document que l'on consulte, probablement pas.