Skills Claude pour Obsidian : créer et utiliser des skills sur son coffre

Une skill Claude est un dossier qui contient un fichier SKILL.md : une procédure écrite une fois, que Claude charge seulement quand votre demande y correspond. Pour Obsidian, elle sert à fixer la façon de ranger, de rédiger ou de vérifier des notes, sans recoller les mêmes consignes à chaque conversation. Vous la placez dans ~/.claude/skills/ pour tous vos projets, ou dans .claude/skills/ à la racine du coffre pour ce coffre seulement. Claude doit d’abord voir votre coffre : la connexion est décrite dans Connecter Obsidian à Claude, Codex ou ChatGPT, et l’installation de Claude Code dans Installer Claude Code et le relier à Obsidian.

Cette page suit la documentation d’Anthropic consultée le 9 novembre 2026. Les trois exemples viennent de ma propre collection de skills ; je dis pour chacun ce qui a été observé et ce qui ne l’a pas été.

Skill, CLAUDE.md, serveur MCP : ce que chacun fait

Trois mécanismes se ressemblent et ne servent pas à la même chose.

La documentation d’Anthropic donne le critère de choix : créez une skill quand vous recollez toujours la même procédure dans la conversation, ou quand une section de CLAUDE.md est devenue une procédure plutôt qu’un fait. Le corps d’une skill ne se charge que lorsqu’elle sert ; au départ, Claude ne voit que son nom et sa description. Une skill ne donne par elle-même aucun accès au coffre : sans connexion, elle décrit une méthode que Claude ne peut pas appliquer.

Le format suit le standard ouvert Agent Skills, que Claude Code étend avec des options propres. D’autres outils le lisent : Codex utilise le même format, dans un dossier différent (voir Codex ou Claude Code pour Obsidian).

Où placer ses skills pour un coffre Obsidian

Pour un coffre, une skill qui parle de votre organisation (vos dossiers, vos modèles de notes) va dans .claude/skills/ du coffre ; une skill générale (écrire un diagramme, nettoyer du Markdown) va dans ~/.claude/skills/. La documentation décrit l’emplacement « projet » pour un dépôt (repository) ; elle ne détaille pas le cas d’un coffre sans Git. Je l’ai essayé le 9 novembre 2026 (Claude Code 2.1.319, Windows 11) : dans un simple dossier, sans Git, la skill placée dans .claude/skills/<nom>/SKILL.md est détectée dès que Claude Code est lancé dans ce dossier. Si une skill du coffre n’apparaît pas chez vous, copiez-la dans ~/.claude/skills/, puis ouvrez une nouvelle session.

Deux limites à connaître. Les skills personnalisées ne se synchronisent pas entre les produits : celles de Claude Code sont des fichiers locaux, distincts de celles de claude.ai ou de l’API, qu’il faut importer séparément. Et le dossier .claude est un dossier caché : Obsidian ne l’affiche pas dans son explorateur de fichiers, vous l’éditez avec un éditeur de texte ou avec Claude lui-même.

Écrire une première skill pour son coffre

Une skill minimale tient en un fichier. L’exemple ci-dessous est un scénario pédagogique que j’ai écrit pour cette page : il suit la structure décrite par la documentation. Je l’ai rejoué tel quel le 9 novembre 2026 dans un coffre de test, sous Windows 11, avec Claude Code 2.1.319 en mode non interactif (claude -p) : à la demande « Range le clipping « Pourquoi les liens comptent » dans le coffre », Claude Code a chargé la skill de lui-même, cherché une note existante, résumé l’article en trois lignes et proposé un dossier et des liens, sans rien écrire.

1. Créez le dossier .claude/skills/ranger-clipping/ à la racine du coffre.
2. Créez-y le fichier SKILL.md :

---
description: Range un article clippé dans le coffre. À utiliser quand je demande de classer, résumer ou rattacher un clipping.
---

## Instructions

1. Cherche d'abord si une note existe déjà sur le sujet, avant d'en créer une.
2. Résume l'article en trois lignes, sans ajouter d'information absente de la source.
3. Propose le dossier cible et les liens à poser. N'écris rien avant que j'aie validé.

3. Ouvrez une nouvelle session de Claude Code dans le coffre, puis tapez /ranger-clipping ou demandez simplement de ranger un clipping. Sans nommer la skill, la demande suffit (testé le 9 novembre 2026) ; je n’ai pas essayé la saisie de /ranger-clipping. La skill porte le nom de son dossier : l’exemple n’a pas de champ name.

Trois règles de la documentation valent pour tout coffre :

• Le champ description est ce que Claude lit pour décider de charger la skill : dites ce qu’elle fait et quand l’utiliser, avec le cas d’usage principal en premier. Le texte affiché dans la liste des skills est tronqué à 1 536 caractères.
• Gardez les consignes longues dans des fichiers à côté de SKILL.md (par exemple un dossier references/) : ils ne se chargent que lorsque la skill les appelle.
• Une option inconnue du frontmatter est ignorée sans message d’erreur : vérifiez l’orthographe des champs.

Trois skills réelles sur un coffre

Voici trois skills de ma collection personnelle. Chacune illustre un usage différent.

Une skill qui garde ce que le modèle ne peut pas deviner : mermaid-obsidian

Claude connaît déjà la syntaxe Mermaid. Ce qu’il ne sait pas, c’est ce que votre version d’Obsidian en fait. Le journal des versions d’Obsidian indique que depuis la 1.15 (version publique du 2 novembre 2026), les diagrammes Mermaid sont dessinés par une bibliothèque nommée Pele, et reprennent les couleurs et les polices du thème. Ma skill ne contient que les écarts avec ce que le modèle suppose : les règles de couleur et d’étiquettes que j’ai relevées, la façon de lier un nœud à une note, le choix du type de diagramme. Moins d’une centaine de lignes, aucun script.

Limite : ces règles sont celles que j’ai consignées pour mon usage ; Obsidian peut changer ce rendu d’une version à l’autre : relisez donc la skill à chaque mise à jour.

Une skill qui impose un ordre de travail : elysia-organisation-notes

Avant de créer une note, cette skill oblige à chercher l’existant par sujet, à résoudre le modèle et le dossier cible, puis à proposer un aperçu sans rien écrire tant que je n’ai pas donné mon accord. La skill transforme ici une habitude de rangement en procédure que Claude applique chaque fois qu’elle se charge.

Limite : elle dépend de la structure de mon coffre (mes dossiers, mes modèles). Le principe se copie ; le fichier, non.

Une skill adossée à un test : excalidraw-obsidian-bridge

Cette skill décrit comment piloter la ligne de commande du plugin Excalidraw pour créer et corriger des schémas dans Obsidian. Je l’ai fait tester par Claude Code le 14 octobre 2026, sous Windows 11, avec Obsidian 1.14.4 et Excalidraw 2.29.0, dans un coffre de test : dessins avec liens créés, corrigés et exportés, et les neuf refus d’écriture provoqués volontairement ont tous été conformes. Un seul agent, une seule machine ; ni coût ni durée mesurés. Le plugin était sorti deux jours plus tôt : ce résultat peut changer vite. L’article sur Excalidraw CLI dans Obsidian détaille ce test.

Des skills prêtes à installer pour Obsidian

Vous n’avez pas à tout écrire. Le dépôt kepano/obsidian-skills, sous licence MIT, rassemble des skills pour Obsidian. Au 9 novembre 2026, son fichier README en liste six :

Le README décrit plusieurs installations : par la place de marché de Claude Code (/plugin marketplace add kepano/obsidian-skills, puis /plugin install obsidian@obsidian-skills), par npx skills add, ou en copiant le contenu du dépôt dans un dossier .claude à la racine du coffre. Je n’ai pas rejoué cette installation pour cette page : suivez le README du dépôt, qui fait foi.

Une précaution vient d’Anthropic : une skill donne à Claude des instructions et parfois du code à exécuter. Lisez tout le contenu d’une skill avant de l’installer, scripts compris, et n’installez que des skills de sources que vous jugez fiables.

Skills et écriture dans le coffre : garder la main

Une skill ne remplace pas les autorisations de Claude Code : en mode manuel, il demande votre accord avant de modifier un fichier ou de lancer une commande. Le champ allowed-tools d’une skill peut pré-approuver certains outils pendant le tour où elle s’exécute ; ne l’utilisez pas pour des outils d’écriture dans un coffre auquel vous tenez. Pour vos premiers essais, travaillez sur un coffre de test ou sur une copie. Les garde-fous d’écriture propres à chaque serveur MCP sont comparés dans Obsidian et agents IA.

Si votre but est un coffre dans lequel l’agent retrouve seul ce qui fait foi, les skills ne suffisent pas : il faut aussi une organisation des notes. C’est ce que construit la formation Obsidian.

Questions fréquentes

Sources

• Anthropic : Extend Claude with skills (Claude Code), consulté le 9 novembre 2026.
• Anthropic : Agent Skills, vue d’ensemble, consulté le 9 novembre 2026.
• Agent Skills : le standard ouvert.
• kepano/obsidian-skills sur GitHub, README consulté le 9 novembre 2026.
• Obsidian : journal des versions, 1.15, consulté le 9 novembre 2026.
• OpenAI : skills dans Codex, consulté le 9 novembre 2026.