Communitygithub.com

heyitsnoah/claudesidian

Assistant de configuration interactif qui aide les nouveaux utilisateurs à créer un fichier CLAUDE.md personnalisé en fonction de leurs préférences de workflow Obsidian. À utiliser lorsque l'utilisateur souhaite configurer claudesidian, intégrer un nouveau coffre, ou exécuter l'assistant bootstrap/init/setup.

Qu'est-ce que claudesidian ?

Cette compétence pour agents IA (Claude Code, Cursor, Codex, etc.) fournit un assistant de configuration interactif complet pour les utilisateurs d'Obsidian. Elle les guide pas à pas dans la création d'un fichier CLAUDE.md personnalisé qui adapte le comportement de l'agent IA à leurs préférences de workflow, leur méthode d'organisation (PARA, Zettelkasten, personnalisée), et leur structure de coffre existante. L'assistant détecte automatiquement les coffres Obsidian existants, analyse leur organisation, et propose une configuration sur mesure incluant la création de dossiers, des modèles de fichiers, et des rituels de révision. Il prend en charge la configuration d'outils optionnels comme Gemini Vision pour l'analyse d'images et Firecrawl pour la recherche web. Le processus est entièrement interactif et adapté à l'utilisateur, qu'il démarre de zéro ou importe un coffre existant. Il valide les chemins utilisateur, gère les cas de multiples coffres, et produit un résumé final avec des prochaines étapes claires.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add https://github.com/heyitsnoah/claudesidian/tree/HEAD/.agents/skills/init-bootstrap

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Initialiser la configuration Bootstrap

Cette commande vous aide à créer un fichier de configuration CLAUDE.md personnalisé en vous posant des questions sur votre workflow Obsidian et vos préférences.

Tâche

Lisez le modèle CLAUDE-BOOTSTRAP.md et recueillez de manière interactive des informations sur l'utilisateur :

  • Structure de coffre existante (le cas échéant)
  • Préférences de workflow
  • Style de prise de notes
  • Méthodes d'organisation
  • Exigences spécifiques

Générez ensuite un fichier CLAUDE.md personnalisé adapté à leurs besoins.

Processus

  1. Configuration initiale de l'environnement

    • Obtenez la date actuelle avec la commande date pour les horodatages
    • Vérifiez le nom du dossier actuel et demandez si l'utilisateur souhaite le renommer
    • Si oui, guidez-le à travers le renommage (gérez le déplacement du répertoire parent)
    • Vérifiez la présence de package.json et installez les dépendances :
      • Essayez pnpm install en premier (plus rapide, meilleur)
      • Repliez-vous sur npm install si pnpm n'est pas disponible
    • Vérifiez que les dépendances principales sont installées
    • Vérifiez le statut git :
      • Si pas de dossier .git : Initialisez le dépôt git
      • Si une origine distante existe : Demandez s'il s'agit d'un travail de développement
        • Coffre personnel : Supprimez l'origine et le dossier .github
        • Contribution : Conservez l'origine et les workflows intacts
      • Si le dépôt local est propre : Prêt à démarrer
    • Ne créez pas encore de dossiers – attendez d'avoir posé des questions sur la méthode d'organisation
  2. Vérifier la configuration existante

    • Recherchez un fichier CLAUDE.md existant
    • S'il existe, demandez si l'utilisateur souhaite le mettre à jour ou repartir de zéro
    • Vérifiez la présence du modèle CLAUDE-BOOTSTRAP.md
  3. Recueillir des informations sur le coffre

    • Recherchez les coffres Obsidian existants (dossier .obsidian) dans les emplacements courants
    • Vérifiez ces chemins avec des limites de profondeur appropriées :
      • ~/Documents (maxdepth 3) – toutes les plateformes
      • ~/Desktop (maxdepth 3) – toutes les plateformes
      • ~/Bibliothèque/Documents Mobiles/iCloud~md~obsidian/Documents (maxdepth 5 – macOS uniquement, coffres iCloud)
      • Répertoire personnel ~/ (maxdepth 2) – toutes les plateformes
      • Répertoire parent actuel (maxdepth 2) – toutes les plateformes
    • Si trouvé, demandez : « Coffre Obsidian trouvé à [chemin]. Est-ce le coffre que vous souhaitez importer ? »
    • Comptez les fichiers correctement : find [chemin] -type f -name "*.md" | wc -l (pas de limite de profondeur)
    • Affichez la taille du coffre : du -sh [chemin]
    • Si confirmé, analysez la structure du coffre :
      • Exécutez tree -L 3 -d [chemin] pour voir la hiérarchie des dossiers
      • Échantillonnez 10 à 15 notes aléatoires pour comprendre les types de contenu
      • Listez 30 à 50 noms de fichiers récents pour détecter les modèles de nommage
      • Vérifiez la présence d'un dossier de notes quotidiennes et son format
      • Identifiez les dossiers les plus actifs par nombre de fichiers
      • Détectez si l'utilisateur utilise PARA, Zettelkasten, Johnny Decimal ou un système personnalisé
    • Si ce n'est pas le bon coffre ou si aucun n'est trouvé :
      • Sur macOS uniquement : Demandez : « Votre coffre est-il stocké dans iCloud Drive ? (oui/non) »
      • Si oui (macOS) : « Veuillez saisir le chemin complet vers votre coffre (ex. /Bibliothèque/Documents Mobiles/iCloudmd~obsidian/Documents/VotreCoffre) »
      • Si non, ou sur Linux/Windows : « Veuillez saisir le chemin vers votre coffre existant, ou tapez 'ignorer' pour repartir de zéro »
      • Validez les chemins fournis par l'utilisateur (voir section « Validation des chemins utilisateur » ci-dessous)
    • Si aucun coffre existant ou si l'utilisateur l'ignore, il repart de zéro
  4. Poser des questions de configuration

    • « Quel est votre nom ? » (pour la personnalisation)
    • « Souhaitez-vous que je recherche vos travaux publics pour mieux comprendre votre contexte ? »
      • Si oui : Recherchez des informations
      • AFFICHEZ TOUJOURS les résultats et demandez « Est-ce correct ? » pour confirmation
      • Si plusieurs personnes trouvées, listez-les numérotées pour sélection
      • Si mauvaise personne, proposez de rechercher à nouveau ou d'ignorer
      • Enregistrez le contexte pertinent sur son travail, son style d'écriture, ses domaines d'expertise
    • « Suivez-vous la méthode PARA ou avez-vous un système d'organisation différent ? »
    • « Quels sont vos principaux cas d'utilisation ? (recherche, écriture, gestion de projet, base de connaissances, notes quotidiennes) »

    Si l'utilisateur utilise PARA, posez des questions de configuration spécifiques : Méthode PARA par Tiago Forte

    • « Sur quels projets actifs travaillez-vous ? » (Créez des dossiers dans 01_Projets)
    • « Quels domaines de responsabilité gérez-vous ? » (ex. Travail, Santé, Finances, Famille)
    • « Quels sujets recherchez-vous fréquemment ? » (Configurez dans 03_Ressources)
    • « Avez-vous récemment terminé des projets ? » (Peut être archivé avec des résumés)

    Préférences générales :

    • Vérifiez .obsidian/community-plugins.json pour voir quels plugins l'utilisateur utilise
    • Analysez les fichiers existants pour détecter automatiquement la convention de nommage
    • Vérifiez la présence d'un dossier pièces-jointes pour voir si l'utilisateur travaille avec des fichiers multimédias
    • « Utilisez-vous git pour le contrôle de version ? »
    • « Y a-t-il des sites Web ou ressources spécifiques que vous consultez souvent ? »
    • « Avez-vous des préférences de style d'écriture particulières ? »
    • « Y a-t-il des workflows ou des modèles que vous souhaitez que Claude suive ? »
    • « Souhaitez-vous un rituel de révision hebdomadaire ? (ex. révision de projet le jeudi) »
    • « Préférez-vous le 'mode réflexion' (questions/exploration) ou le 'mode écriture' ? »
  5. Configuration optionnelle des outils

    Gemini Vision (déjà inclus)

    • Demandez : « Gemini Vision est déjà inclus pour analyser les images, PDF et vidéos. Souhaitez-vous l'activer ? (oui/non/plus tard) »
    • Expliquez : « Vous avez juste besoin d'une clé API gratuite de Google. Cela permet à Claude d'analyser tout contenu visuel dans votre coffre. »
    • Si plus tard : « Pas de problème ! Vous pouvez le configurer à tout moment en obtenant une clé API sur https://aistudio.google.com/apikey et en ajoutant GEMINI_API_KEY à votre profil shell, puis en exécutant claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs. »
    • Si oui :
      • Guidez pour obtenir une clé API sur https://aistudio.google.com/apikey (gratuit, prend 30 secondes)
      • Aidez à l'ajouter au profil shell (.zshrc, .bashrc, etc.)
      • Exécutez claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs
      • Configurez .mcp.json avec la clé API
      • Testez la connexion avec une commande exemple

    Firecrawl (déjà inclus)

    • Demandez : « Firecrawl est inclus pour la recherche Web. Souhaitez-vous le configurer ? (oui/non/plus tard) »
    • Expliquez : « C'est un changement de donne pour la recherche ! Lorsque vous trouvez un article ou un site Web, vous pouvez l'enregistrer directement dans votre coffre au format markdown – préservant le contenu pour toujours, le rendant consultable et permettant à Claude de l'analyser. Parfait pour constituer une bibliothèque de recherche. »
    • Exemple : « Dites simplement à Claude : 'Enregistre cet article dans mon coffre : [URL]' et c'est fait ! »
    • Si plus tard : « Vous pouvez le configurer à tout moment en obtenant une clé API sur https://firecrawl.dev et en configurant les scripts dans .scripts/. »
    • Si oui :
      • Guidez pour obtenir une clé API sur https://firecrawl.dev (niveau gratuit disponible)
      • Aidez à configurer les scripts dans .scripts/
      • Montrez un exemple d'utilisation : .scripts/firecrawl-scrape.sh https://exemple.com
  6. Générer la configuration personnalisée

    • Obtenez la date actuelle : date +"%B %d, %Y" pour l'en-tête CLAUDE.md
    • Enregistrez les préférences dans .claude/vault-config.json :
      {
        "user": {
          "name": "Jane Smith",
          "background": {
            "companies": ["Variance", "Percolate"],
            "roles": ["Co-fondateur", "Écrivain"],
            "publications": ["Why Is This Interesting?", "every.to"],
            "expertise": [
              "Outils de développement",
              "Technologie marketing",
              "Pensée systémique"
            ],
            "interests": ["IA pour la réflexion", "Systèmes de prise de notes", "Créativité"]
          },
          "profileSources": [
            "https://whyisthisinteresting.com/about",
            "https://every.to/@nomutilisateur"
          ],
          "customContext": "Se concentre sur l'IA comme augmentation de la réflexion, pas seulement l'écriture",
          "publicProfile": true
        },
        "vaultPath": "/chemin/vers/coffre/existant",
        "fileNamingPattern": "modèle-détecté",
        "organizationMethod": "PARA",
        "primaryUses": ["recherche", "écriture", "projets"],
        "tools": {
          "geminiVision": true,
          "firecrawl": false
        },
        "projects": ["Livre - Productivité", "Application SaaS"],
        "areas": ["Newsletter", "Santé"],
        "importedAt": "2025-01-13",
        "lastUpdated": "2025-01-13"
      }
      
    • Commencez avec CLAUDE-BOOTSTRAP.md comme base
    • Ajoutez des sections spécifiques à l'utilisateur :
      • Structure de dossiers personnalisée avec ses projets/domaines réels
      • Workflows personnels
      • Outils et scripts préférés
      • Directives spécifiques
      • Configuration MCP si configurée
    • Incluez ses sites Web/ressources si fournis
    • Ajoutez toutes conventions de nommage personnalisées
    • Pré-remplissez avec ses projets et domaines :
      • Créez des dossiers de projet dans 01_Projets/
      • Créez des dossiers de domaine dans 02_Domaines/
      • Créez des sujets de ressources dans 03_Ressources/
      • Ajoutez des fichiers README expliquant chaque projet/domaine
  7. Importer le coffre existant (si applicable)

    • Si l'utilisateur a un coffre existant :
      • Créez le dossier ANCIEN_COFFRE : mkdir ANCIEN_COFFRE
      • Copiez l'intégralité du coffre en préservant la structure : cp -r [chemin-coffre]/* ./ANCIEN_COFFRE/
      • Copiez la configuration Obsidian : cp -r [chemin-coffre]/.obsidian ./
      • Vérifiez et copiez d'autres fichiers importants :
        • .trash/ (corbeille Obsidian)
        • .smart-connections/ (si ce plugin est utilisé)
        • Tous fichiers d'espace de travail : .obsidian.vimrc, etc.
      • Ne copiez pas : .git/ (ils auront le leur), .claude/ (nous utilisons le nôtre)
      • Affichez un résumé : « Coffre importé dans ANCIEN_COFFRE/ (X fichiers, Y dossiers) »
      • Expliquez : « Votre structure d'origine est préservée dans ANCIEN_COFFRE. Vous pouvez migrer progressivement les fichiers vers les dossiers PARA selon vos besoins. »
  8. Créer les fichiers de support

    • Générez une structure de dossiers initiale si nouveau coffre
    • Créez des fichiers README pour les dossiers principaux
    • Pour chaque dossier de projet, créez des sous-dossiers :
      • Recherche/ (documents sources)
      • Discussions/ (conversations IA)
      • Progrès Quotidiens/ (journal continu)
    • Créez le répertoire 05_PiècesJointes/Organisé/
    • Configurez .gitignore si utilisation de git (incluez .mcp.json, node_modules)
    • Créez des modèles initiaux si demandé
    • Créez RÉVISION_HEBDOMADAIRE.md si l'utilisateur souhaite un rituel de révision
    • Supprimez le fichier marqueur PREMIER_EXÉCUTION s'il existe
    • Effectuez le premier commit git si le dépôt a été initialisé
  9. Exécuter les commandes de test

    • Exécutez pnpm vault:stats pour vérifier que les scripts fonctionnent
    • Testez les commandes de pièces jointes si les dossiers existent
    • Testez les outils MCP si configurés
    • Vérifiez que git suit correctement les fichiers
  10. Fournir les prochaines étapes

  • Résumé de ce qui a été créé et configuré
  • Guide de démarrage rapide spécifique à leur configuration
  • Liste des commandes disponibles qu'ils peuvent utiliser
  • Commandes de test pour vérifier que tout fonctionne
  • Suggestions pour les premières tâches en fonction de leurs cas d'utilisation
  • Comment modifier la configuration plus tard

Exemple de sortie

# Configuration de votre coffre Obsidian

Généré le : [Exécutez `date +"%B %d, %Y"` pour obtenir la date actuelle] Dernière mise à jour : [Même date] Basé sur vos préférences pour : [principaux cas d'utilisation] Configuration terminée avec : ✅ Dépendances ✅ Structure de dossiers ✅ Git initialisé

## Votre structure de dossiers personnalisée

[Leur structure spécifique avec explications]

## Vos workflows

### Routine quotidienne

[Basé sur leurs réponses]

### Gestion de projet

[Leur approche spécifique]

### Méthode de recherche (Style Noah Brier)

- Capturez tout ce que vous lisez
- Laissez les idées importantes refaire surface naturellement
- Commencez par écrire pour tester votre compréhension
- Utilisez la recherche, pas les tags, pour trouver les choses
- [En savoir plus sur le système de Noah](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)

### Rituel de révision hebdomadaire

[Si activé : Tous les jeudis à 16h, révisez tous les projets]

## Vos préférences

### Nommage des fichiers

- Modèle : [leur convention]
- Exemples : [exemples spécifiques]

### Outils et scripts

[Scripts pertinents pour leur workflow]

## Serveurs MCP (si configurés)

### Gemini Vision

- Statut : ✅ Configuré et testé
- Clé API : Définie dans .mcp.json
- Testez avec : `Utilisez gemini-vision pour analyser [chemin image]`

## Commandes disponibles

### Gestion du coffre

- `pnpm vault:stats` - Afficher les statistiques du coffre
- `pnpm attachments:list` - Lister les pièces jointes non traitées
- `pnpm attachments:organized` - Compter les fichiers organisés

### Compétences Claude

Les compétences se découvrent automatiquement lorsque vous décrivez la tâche. Exemples :

- « Aide-moi à réfléchir à X » → `partenaire-de-réflexion`
- « Termine ma journée » / « Révision quotidienne » → `révision-quotidienne`
- « Traite ma boîte de réception » → `processeur-boîte-réception`
- « Relance l'assistant de configuration » → `init-bootstrap`

Les compétences se trouvent dans `.agents/skills/` (canonique) avec des liens symboliques dans `.claude/skills/` et `.pi/skills/`. Elles fonctionnent dans Claude Code, OpenCode, Codex, Cursor et Pi.

## Démarrage rapide

1. [Première étape personnalisée]
2. [Action suivante basée sur leurs objectifs]
3. [Spécifique à leur workflow]

## Conseils de pro des maîtres de la recherche

- **Soyez un maximaliste de tokens** : Fournissez beaucoup de contexte à Claude
- **L'écriture évolue** : Documentez tout pour référence future
  ([Noah Brier](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452))
- **Faites confiance à l'émergence** : Les idées importantes continueront de refaire surface
- **Commencez par écrire** : Démarrez toujours les projets sous forme de texte
- **Révisez régulièrement** : Réservez du temps chaque semaine pour élaguer et mettre à jour
- **Méthode PARA** : Projets, Domaines, Ressources, Archives
  ([Tiago Forte](https://fortelabs.com/blog/para/))

## Résumé de la configuration

✅ Dépendances installées (pnpm/npm) ✅ Structure de dossiers créée ✅ Dépôt git initialisé et déconnecté de l'original ✅ CLAUDE.md personnalisé ✅ Configuration de première exécution terminée [✅ MCP Gemini Vision configuré - si mis en place] [✅ Premier commit effectué - si git a été initialisé]

Notes d'implémentation importantes

Gestion de multiples coffres

Lorsque plusieurs coffres sont détectés :

  1. Listez toujours tous les coffres trouvés avec une numérotation claire et des détails
  2. Exigez une sélection explicite - ne présumez pas quel coffre utiliser
  3. Confirmez la sélection avant de procéder à l'importation
  4. Gérez les réponses ambiguës - si l'utilisateur fournit une entrée peu claire (comme coller une capture d'écran), demandez une clarification :
    • « Je vois que vous avez partagé une capture d'écran. Pourriez-vous saisir le numéro (1-3) du coffre que vous souhaitez importer ? »
    • « J'ai besoin d'une sélection claire. Veuillez saisir '1', '2', ou '3' pour choisir un coffre. »

Validation des chemins utilisateur

Lorsque l'utilisateur fournit un chemin de coffre :

  1. Vérifiez que le chemin existe : test -d [chemin]
  2. Confirmez qu'il s'agit d'un coffre Obsidian : Vérifiez [chemin]/.obsidian
  3. Gérez les caractères d'expansion : N'utilisez pas ~ directement dans les scripts ; utilisez $HOME ou évaluez avec le shell
  4. Échouez gracieusement si le chemin est invalide et redemandez
  5. Support des chemins Windows : Utilisez des chemins avec barre oblique (C:/Utilisateurs/...) ou échappez les barres obliques inverses (C:\\Utilisateurs\\...)

Gestion des erreurs

  • Si les dépendances échouent à s'installer, passez à npm et informez l'utilisateur
  • Si l'importation du coffre échoue (manque d'espace disque, permissions), informez l'utilisateur et passez à l'étape de génération
  • Si la configuration MCP échoue, marquez-la comme non configurée et passez à autre chose
  • Journalisez toujours les erreurs dans un fichier temporaire pour déboguer

Compatibilité multiplateforme

  • Détection du système d'exploitation : uname -s (Darwin=macOS, Linux=Linux, MINGW/CYGWIN=Windows)
  • Chemins iCloud : macOS uniquement
  • Chemins Windows : Gestion spéciale des chemins avec des fichiers batch ou PowerShell si nécessaire
  • Gestionnaires de paquets : pnpm > npm (pas de yarn en raison de la non-compatibilité)
  • Commandes : Utilisez toujours -- pour séparer les options des arguments dans find

Skills associés