CommunityRédaction et éditiongithub.com

steipete/obsidian

Coffre Obsidian : rechercher/lire/écrire des notes, backlinks, Bases, Canvas.

Qu'est-ce que obsidian ?

Cette compétence (skill) permet à un agent IA, comme Claude Code ou Cursor, d'interagir avec un coffre (vault) Obsidian local. Elle offre des commandes pour rechercher, lire, créer et modifier des notes Markdown, ainsi que pour accéder aux backlinks, aux bases de données Obsidian Base et aux fichiers Canvas. L'agent peut utiliser l'interface en ligne de commande officielle d'Obsidian (`obsidian`) pour des opérations contextuelles (recherche, liens, propriétés) ou lire directement les fichiers via le système de fichiers pour des besoins précis. La compétence inclut des workflows de sécurité, comme éviter les réécritures en masse et préserver le frontmatter et les wikilinks, ce qui en fait un outil fiable pour la gestion de connaissances personnelles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/obsidian

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait obsidian ?

Utilisez cette compétence pour travailler avec un coffre Obsidian local. Un coffre Obsidian est un dossier normal contenant des fichiers Markdown et une configuration .obsidian/.

Sources

  • Configuration de l'application : ~/Library/Application Support/obsidian/obsidian.json
  • Nom de coffre par défaut : obsidian
  • Chemin de coffre local habituel : ~/obsidian
  • CLI officielle : obsidian
  • Les commandes du coffre résolvent le coffre depuis le répertoire courant ; exécutez-les depuis ~/obsidian.

Premières vérifications

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

Les commandes globales comme version et vaults fonctionnent en dehors d'un coffre. Les commandes liées au contenu d'un coffre peuvent afficher Vault not found. en dehors de ~/obsidian. Utilisez obsidian commands, pas obsidian help, pour découvrir la CLI.

Si obsidian indique que la CLI est désactivée :

  1. Demandez d'abord à l'utilisateur d'activer Paramètres -> Général -> Avancé -> Interface en ligne de commande.
  2. Si vous avez déjà confirmé la forme de la configuration de l'application, ~/Library/Application Support/obsidian/obsidian.json utilise "cli": true.
  3. Redémarrez Obsidian après avoir modifié la configuration CLI au niveau de l'application.

Workflow de lecture

Privilégiez la CLI officielle pour les recherches tenant compte d'Obsidian :

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json

Utilisez les lectures directes du système de fichiers lorsque vous connaissez déjà le chemin et avez besoin des octets exacts :

sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "terme" "$HOME/obsidian"

Indiquez la source utilisée lorsque la fraîcheur ou le choix du coffre est important.

Workflow d'écriture

Choisissez le chemin d'écriture le plus précis :

  • Nouvelle note : obsidian create path="Folder/Note.md" content="...".
  • Ajouter au début/à la fin des notes quotidiennes : obsidian daily:append content="...".
  • Modifications simples de notes : utilisez apply_patch sur le fichier Markdown.
  • Renommer/déplacer des notes : privilégiez obsidian move path="Old.md" to="Folder/New.md" pour que les liens puissent être mis à jour.
  • Ouvrir l'interface après une écriture : ajoutez open seulement si cela est utile ou demandé.

Commandes courantes :

cd ~/obsidian
obsidian create path="Notes/New.md" content="# Nouveau\n\nCorps"
obsidian append path="Notes/New.md" content="Texte supplémentaire"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Élément de suivi"

Pour du contenu multiligne, privilégiez la modification du fichier .md avec apply_patch une fois le chemin connu. Évitez les guillemets fragiles du shell pour les longs textes.

Bases, Canvas, Plugins

Utilisez d'abord la découverte par CLI :

cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

Pour les fichiers .canvas, .base et .json, lisez/modifiez-les en tant que données structurées lorsque c'est possible. Maintenez un formatage stable et validez le JSON après les modifications.

Sécurité

  • Ne réécrivez pas le coffre en masse. Utilisez des chemins ciblés et examinez les différences.
  • Ne modifiez pas .obsidian/ sauf si l'utilisateur le demande ou si la tâche concerne explicitement la configuration ou les plugins.
  • Ne supprimez pas de notes sauf demande explicite ; privilégiez la corbeille à la suppression définitive.
  • Ne créez pas de notes dans des dossiers cachés (commençant par un point) via le chemin URI/CLI d'Obsidian.
  • Préservez le frontmatter et les wikilinks sauf si la tâche consiste à les refactoriser.
  • Si plusieurs coffres existent, ne devinez pas ; utilisez obsidian vaults et obsidian.json.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills associés