/ Annuaire / Playground / Obsidian Skills (kepano)
● Communauté kepano ⚡ Instantané

Obsidian Skills (kepano)

par kepano · kepano/obsidian-skills

Skills de kepano (directeur design d'Obsidian) qui enseignent aux agents le vrai Obsidian — Markdown, Bases, JSON Canvas, le CLI.

obsidian-skills est un bundle de skills de Steph Ango (kepano), directeur design d'Obsidian. Au lieu de traiter Obsidian comme « juste un dossier de .md », il enseigne à l'agent les vraies conventions : backlinks, Properties, requêtes Dataview/Bases, JSON Canvas, embeds. Plus des skills pour utiliser le CLI Obsidian afin d'opérer sur un vault de façon programmatique.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-skills-kepano",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-skills-kepano": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/kepano/obsidian-skills",
          "~/.claude/skills/obsidian-kepano"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add obsidian-skills-kepano -- git clone https://github.com/kepano/obsidian-skills ~/.claude/skills/obsidian-kepano

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Obsidian Skills (kepano)

Nettoyer un vault Obsidian désordonné avec des properties cohérentes

👤 Utilisateurs Obsidian de longue date ⏱ ~60 min intermediate

Quand l'utiliser : Des années de notes — tags incohérents, properties, nommage de fichiers.

Prérequis
  • Chemin du vault Obsidian — Pointez le skill vers lui
Déroulement
  1. Auditer
    Utilise obsidian-skills. Audite /vault — liste les incohérences dans les properties, les liens morts, les notes orphelines.✓ Copié
    → Inventaire des problèmes
  2. Normaliser
    Migre tag: vers les properties YAML tags: de façon cohérente.✓ Copié
    → Diffs sur les notes affectées
  3. Vérifier
    Ré-audite. Confirme que les orphelins ont une place et que les properties sont cohérentes.✓ Copié
    → Audit propre

Résultat : Vault qui recherche et se lie proprement.

Pièges
  • Les modifications en masse cassent des plugins — Testez d'abord sur une copie de sauvegarde ; le skill le suggère
Combiner avec : filesystem

Convertir un dossier de notes en Base Obsidian

👤 Utilisateurs adoptant Bases pour le suivi de projets ⏱ ~45 min intermediate

Quand l'utiliser : Vous voulez une vue typée sur vos notes de projet.

Déroulement
  1. Schéma
    Regarde /vault/projects. Propose un schéma Base — properties, types, valeurs par défaut.✓ Copié
    → Spec de schéma
  2. Migrer
    Mets à jour chaque note de projet pour se conformer. Backfille les valeurs par défaut où manquantes.✓ Copié
    → Les notes se conforment ; la vue Base fonctionne

Résultat : Base fonctionnelle ; vous pouvez trier, filtrer, grouper vos projets.

Pièges
  • Incompatibilités de types de property — Le skill valide les types — corrigez les notes signalées avant que la Base se charge proprement

Générer un JSON Canvas de notes liées sur un sujet

👤 Chercheurs / écrivains ⏱ ~30 min intermediate

Quand l'utiliser : Vous voulez une carte visuelle de comment les notes se connectent sur un sujet.

Déroulement
  1. Regrouper
    Trouve les notes liées aux « systèmes distribués ». Regroupe par sous-thème.✓ Copié
    → Liste de clusters
  2. Rendre
    Rends en JSON Canvas avec des boîtes groupées et des arêtes pour les backlinks.✓ Copié
    → Fichier .canvas écrit

Résultat : Un canvas que vous pouvez ouvrir dans Obsidian et explorer visuellement.

Pièges
  • La mise en page se chevauche — Le skill inclut une auto-disposition basique ; affinez dans Obsidian

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

obsidian-skills-kepano + filesystem

Accès direct aux fichiers pour les modifications du vault

Lecture/écriture de notes via filesystem ; obsidian-skills gère les conventions.✓ Copié
obsidian-skills-kepano + claude-obsidian-skill

Superposer avec le skill Claude×Obsidian de Daniel

Utilisez les deux — kepano pour les conventions, claude-obsidian pour le workflow quotidien.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
audit_vault path Nettoyage périodique tokens proportionnels à la taille du vault
design_base dossier Adoption de Bases tokens
render_canvas note_set, layout? Cartes visuelles tokens
obsidian_cli commande Opérations en masse via CLI tokens pour le parsing de la sortie

Coût et limites

Coût d'exécution

Quota d'API
N/A
Tokens par appel
Élevé sur les gros vaults ; cibler par dossier aide
Monétaire
Gratuit
Astuce
Auditez par dossier, pas tout le vault, à la première exécution

Sécurité

Permissions, secrets, portée

Portées minimales : Lecture/écriture dans le vault
Stockage des identifiants : Aucun
Sortie de données : Aucune

Dépannage

Erreurs courantes et correctifs

Schéma Bases rejeté

Les types de property doivent correspondre dans toutes les notes — le skill signale les contrevenants

Canvas qui se chevauche

Réduisez la taille du cluster ou ouvrez dans Obsidian pour un nettoyage manuel

Commande CLI introuvable

Installez le CLI Obsidian séparément ; le skill suppose qu'il est dans le PATH

Alternatives

Obsidian Skills (kepano) vs autres

AlternativeQuand l'utiliserCompromis
claude-obsidian-skillVous voulez des patterns de workflow quotidienMoins de couverture des nouvelles fonctionnalités Bases / Canvas
Usage manuel d'ObsidianVault de petite tailleNe passe pas à l'échelle pour des milliers de notes

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills