Skip to content

DOC

Obsidian Skills Integration — Guide ULK-047

Obsidian Skills Integration

Ce guide documente l’intégration des skills kepano/obsidian-skills dans ulk, disponibles via le flag --with-obsidian-skills.

Crédits : Skills créés par Steph Ango (kepano) — https://stephango.com · Licence MIT

Installation

# Installer ulk avec les skills Obsidian
./install.sh --with-obsidian-skills

# Combinable avec d'autres flags
./install.sh --with-obsidian-skills --with-memory-loop

Les deux skills sont installés dans ~/.claude/skills/ :

  • kepano-obsidian-markdown/ — Formatage Markdown Obsidian
  • kepano-defuddle/ — Nettoyage de contenu web

Skills disponibles

obsidian-markdown

Formate le contenu Markdown selon les conventions Obsidian :

  • Frontmatter YAML (title, date, tags, aliases)
  • Wikilinks ([[Note Name]], [[Note|Display]])
  • Callouts Obsidian (> [!NOTE], > [!WARNING], etc.)
  • Structure de vault recommandée
  • Maps of Content (MOC)
  • Compatibilité Dataview

Quand l’utiliser :

  • Créer ou convertir des notes pour un vault Obsidian
  • Ajouter du frontmatter à des fichiers Markdown existants
  • Générer des fichiers MOC (index de notes)
  • Construire de la documentation structurée pour Obsidian

Ce qu’il ne fait PAS :

  • Ne remplace pas le format Monoboard Kanban (docs/todo.md)
  • Ne nécessite pas qu’Obsidian soit installé
  • Ne modifie pas les fichiers agents/

defuddle

Nettoie le contenu web pour en extraire l’essentiel :

  • Supprime navigation, publicités, popups, bas de page
  • Préserve le contenu principal (article, code, images)
  • Convertit en Markdown propre avec frontmatter Obsidian
  • Supprime les paramètres de tracking des URLs

Quand l’utiliser :

  • Sauvegarder des articles web dans un vault Obsidian
  • Convertir du HTML en Markdown lisible
  • Préparer du contenu web pour Obsidian Web Clipper
  • Extraire la documentation d’une page web complexe

Intégration avec les agents ulk

Agent shuri (01) — mode=sync

Peut appliquer les conventions obsidian-markdown lors de la synchronisation de la documentation :

shuri mode=sync → détecte un vault Obsidian → applique obsidian-markdown pour le frontmatter

Agent strange (16) — reverse documentation

Peut appliquer defuddle lors de l’extraction de contenu depuis des sources web :

strange → rencontre du HTML/web → applique defuddle → produit du Markdown propre

Agent lovecraft (47) — memory loop

Le flag --with-obsidian-skills est un prérequis recommandé avant d’activer le memory loop, car lovecraft génère des notes de vault Obsidian :

# Recommandé : activer les deux ensemble
./install.sh --with-obsidian-skills --with-memory-loop

Agent obsidian-vault (39)

L’agent obsidian-vault peut déléguer le formatage de frontmatter et wikilinks aux skills kepano plutôt que de réimplémenter ces conventions en inline.

Obsidian Bases (expérimental)

Gated derrière --with-obsidian-skills — non installé par défaut

Les Obsidian Bases permettent des requêtes de type base de données sur les notes. Cette fonctionnalité est expérimentale et non encore intégrée dans lovecraft (47).

Pour suivre l’avancement : voir #ULK-047 dans docs/todo.md.

Fichiers source

Les skills sont stockés dans :

community-skills/kepano/
├── obsidian-markdown/
│   └── SKILL.md
└── defuddle/
    └── SKILL.md

Les fichiers installés dans ~/.claude/skills/ sont des copies — modifier les sources dans community-skills/kepano/ et relancer ./install.sh --with-obsidian-skills pour mettre à jour.

Crédits et licence

Les skills sont redistribués sous licence MIT conformément aux termes originaux. La licence complète est disponible dans community-skills/kepano/ (à créer si nécessaire).