Le PDG de la société qui développe Obsidian a publié un manuel d'instructions IA gratuit.
Vous pouvez le trouver ici :
https://github.com/kepano/obsidian-skills
Il contient seulement 5 fichiers texte. L'installation ne prend que 5 minutes et ne cassera aucune de vos notes existantes.
En les ajoutant, l'IA comprendra le formatage spécifique à Obsidian. C'est la réponse officielle au problème « l'IA abîme mes notes ».
Quand j'ai vu ce sujet devenir brûlant et que j'ai ouvert mon propre environnement pour l'installer, je me suis rendu compte qu'il y était déjà...
La date du fichier était le 26 avril. Je les avais installés trois mois et demi plus tôt et j'avais complètement oublié leur existence (lol).
Alors, qu'est-ce qui a changé dans mon Obsidian pendant ces trois mois et demi ? J'étais curieux, mais les résultats ont été assez décevants.
Pour aller droit au but : les instructions officielles ne suffisent pas. Il vous manque une page supplémentaire à écrire vous-même.
Ce que l'IA ne connaît pas, c'est la syntaxe spécifique à Obsidian
Obsidian possède plusieurs fonctionnalités uniques qui le distinguent des applications de notes standard.
Pour lier des notes, on les entoure de [[ ]]. (Liens)
Pour faire ressortir une note, on utilise une syntaxe spécifique pour créer un encadré coloré. (Callouts)
Tout en haut d'un fichier, il y a une section pour les dates et les tags. (Propriétés)
L'IA écrit sans connaître tout cela. Le texte peut donc sembler correct, mais quand vous l'ouvrez dans Obsidian, les liens ne sont pas connectés ou les encadrés n'apparaissent pas.
Les 5 fichiers que j'ai mentionnés au début comblent cette lacune. Ils se répartissent comme suit :
- obsidian-markdown (Syntaxe correcte pour les liens et les encadrés)
- obsidian-bases (Organiser les notes comme un tableau de base de données)
- json-canvas (Créer des diagrammes reliant les notes avec des lignes)
- obsidian-cli (Rechercher dans tout le coffre via des commandes)
- defuddle (Importer des pages web sous forme de notes propres)
Vous pouvez les obtenir gratuitement via le lien ci-dessus.
Ils ne sont spécifiques à aucun outil d'IA, donc ils fonctionnent aussi bien avec Claude Code qu'avec Codex.
Presque rien n'a changé après 3,5 mois avec elles installées
Honnêtement, j'ai ri en les retrouvant. J'avais déjà les fameuses instructions... et je ne m'en étais même pas rendu compte (lol).
Cependant, comme elles ne fonctionnaient que dans Claude Code, j'ai copié les mêmes 5 fichiers dans Codex le 9 août pour pouvoir les utiliser depuis l'un ou l'autre.
Maintenant, voici le point principal.
Qu'est-ce qui a changé dans mon Obsidian après trois mois et demi ?
- Notes utilisant des callouts : 32 sur 1 387
- Vues de base de données : 1
- Canvas : 1
Presque rien n'a changé.
Ce n'est pas pour dire que les instructions officielles sont mauvaises. Naturellement, le contenu est bien fait.
Quand je les ai installées la première fois, je les ai essayées, je me suis dit « Oh, c'est pratique », et c'est tout. Parce que je n'avais pas décidé quand les utiliser, c'était le résultat naturel.
La raison pour laquelle rien n'a changé est claire : les instructions officielles enseignent le « comment écrire ».
Savoir écrire n'augmente pas le contenu que vous écrivez. Cela ne décide pas non plus où placer les choses.
Il existe deux types d'instructions à donner à l'IA
Je pense que c'est très important.
Il existe deux types de manuels d'instructions à donner à une IA.
- La syntaxe Obsidian correcte. C'est la même pour tout le monde, c'est donc l'équipe officielle qui la fournit.
- Vos propres règles internes. Où mettre quoi. Quelles zones sont modifiables. Où doivent aller les produits finis.
L'équipe officielle ne fournit que le premier.
Et la cause d'un coffre en désordre est généralement le second. Un contenu bien écrit mais placé au mauvais endroit est plus problématique qu'une erreur de syntaxe.
C'est là que vous rencontrez des problèmes sans « règles internes » :
- Les articles terminés sont enregistrés dans un dossier différent à chaque fois.
- L'IA ajoute du texte dans un journal que vous vouliez garder en lecture seule.
- Même si vous avez renommé un dossier, de nouvelles notes continuent d'apparaître sous l'ancien nom.
Dans tous ces cas, la syntaxe est parfaite. Seuls l'emplacement et la gestion sont erronés.
Par exemple, les instructions officielles disent : « Reliez les notes connexes avec des liens. » C'est correct.
Mais ma règle est l'inverse : je ne lie que les notes que je vais « certainement ouvrir plus tard ». Si j'augmente trop les liens, je ne retrouve plus rien.
Ce n'est pas une question de savoir qui a raison ; c'est simplement que le guide officiel ne peut pas tenir compte de ma situation particulière.
Quelle que soit votre utilisation de l'IA, vos actifs n'augmenteront pas tout seuls. Vous avez déjà les matériaux ; il vous manque simplement le « conteneur ».
Les instructions officielles vous apprennent la « forme » du conteneur, mais c'est à vous de décider quoi mettre où.
━━━━━━━━━━━━
Pour ceux qui utilisent l'IA mais trouvent que la création de contenu ne devient pas plus facile :
Arrêtez de repartir de zéro à chaque fois en gardant vos matériaux au même endroit.
J'ai lancé le « Journal de mise en œuvre d'Obsidian x Agents IA de Minami ».
À lire gratuitement ici ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
Les 4 éléments minimum nécessaires pour vos règles internes
J'ai créé un fichier unique dans Obsidian appelé « Règles de fonctionnement » et j'y ai tout écrit. Claude et Codex lisent tous deux ce fichier avant de commencer le travail.
Voici les 4 éléments qui suffisent à faire fonctionner les choses :
- Zones modifiables vs zones en lecture seule. Dans mon cas, les journaux, les clips web et les notes non triées sont en lecture seule. C'est la partie la plus importante.
- Destination des travaux finis. Fixez les emplacements : les posts X vont ici, les articles Note vont là. Cela évite à l'IA de demander à chaque fois.
- Voie de sortie en cas d'indécision. Si vous hésitez pendant 3 secondes, mettez-la dans « Non trié ». Cela vous évite de rester bloqué sur la classification.
- Décidez d'un endroit unique pour fixer les règles. N'écrivez pas les règles de fonctionnement dans des notes au hasard. Fixez le fichier maître.
Surtout le 4e. Sans cela, les règles se dispersent partout et vous perdez de vue quelle est la dernière version.
Je fais des vérifications hebdomadaires pour que cela ne s'arrête pas à l'installation
Parmi les 5 fichiers mentionnés précédemment, il y a obsidian-cli, qui permet d'inspecter tout le coffre avec des commandes. Il détecte les notes orphelines, le nombre d'utilisations de chaque tag et les liens cassés.
C'est utile, mais cela ne fonctionne que si vous l'exécutez.
J'ai donc configuré cette « inspection » pour qu'elle s'exécute automatiquement chaque semaine. Elle se lance toute seule le dimanche matin et produit un rapport listant les liens cassés potentiels et les notes négligées.
Le plus grand avantage est de ne pas avoir à y penser.
L'avoir installé et le faire tourner sont deux choses différentes.
Je peux en parler : chez moi, c'est resté installé trois mois et demi sans que rien ne change, donc j'ai probablement raison (lol).
En conclusion
Installer les instructions officielles prend 5 minutes. C'est gratuit et cela ne cassera pas vos notes. Il n'y a aucun inconvénient à le faire.
Mais cela ne change que la syntaxe.
Si Obsidian devient désordonné quand on le confie à l'IA, ce n'est pas parce que vous l'utilisez mal. C'est simplement parce qu'il vous manque encore un fichier de « règles internes » unique que l'IA peut lire.
Alors, ne pensez pas que vous devez tout mémoriser avant de déléguer. L'équipe officielle fournit la syntaxe ; vous n'avez qu'à écrire une page.
Si vous comptez le faire aujourd'hui, commencez par écrire une ligne pour séparer ce que l'IA peut toucher de ce qu'elle ne peut pas toucher. « Le dossier des journaux est en lecture seule. Ne le réécrivez pas » suffit.
Cela réduira déjà considérablement le nombre de corrections à faire après le passage de l'IA.
━━━━━━━━━━━━
Merci d'avoir lu jusqu'au bout !
Annonce 📢
J'anime un Open Chat !
Avec pour objectif de faire grandir la communauté des « Obsidiens », je partage chaque jour des histoires sur Obsidian x Agents IA que je ne publie pas sur X.
Je distribue aussi des cadeaux, donc si vous êtes intéressé, jetez un œil ↓
