CommunityRedacción y edicióngithub.com

steipete/obsidian

Bóveda de Obsidian: buscar, leer y escribir notas, enlaces inversos, Bases y Canvas.

¿Qué es obsidian?

Este skill proporciona acceso completo a una bóveda local de Obsidian, permitiendo a un agente de IA buscar, leer, crear, modificar y mover notas de Markdown, así como trabajar con enlaces inversos, bases de datos (Bases) y archivos Canvas. Es útil para cualquier tarea que requiera interactuar con una bóveda de Obsidian sin intervención manual, como la gestión de conocimiento, la automatización de notas diarias o la consulta de propiedades y comandos. Funciona con el CLI oficial de Obsidian en macOS (ruta típica `~/obsidian`) y también puede fallar a la lectura directa del sistema de archivos. Incluye comprobaciones de seguridad para evitar modificaciones masivas, edición de archivos de configuración ocultos o eliminación permanente, y recomienda usar rutas específicas y revisar diferencias antes de aplicar cambios.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace obsidian?

Úsalo para trabajar con una bóveda local de Obsidian. Una bóveda de Obsidian es una carpeta normal con archivos Markdown más la configuración de .obsidian/.

Fuentes

  • Configuración de la app: ~/Library/Application Support/obsidian/obsidian.json
  • Nombre de bóveda por defecto: obsidian
  • Ruta local habitual de la bóveda: ~/obsidian
  • CLI oficial: obsidian
  • Los comandos de bóveda resuelven la bóveda desde el directorio de trabajo actual; ejecútalos desde ~/obsidian.

Primeras comprobaciones

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

Los comandos globales como version y vaults funcionan fuera de una bóveda. Los comandos de contenido de bóveda pueden imprimir Vault not found. fuera de ~/obsidian. Usa obsidian commands, no obsidian help, para descubrir la CLI.

Si obsidian indica que la CLI está deshabilitada:

  1. Prefiere pedir al usuario que la habilite en Configuración -> General -> Avanzado -> Interfaz de línea de comandos.
  2. Si ya confirmaste la forma del archivo de configuración de la app, ~/Library/Application Support/obsidian/obsidian.json usa "cli": true.
  3. Reinicia Obsidian después de cambiar la configuración de CLI a nivel de app.

Flujo de lectura

Prefiere el CLI oficial para búsquedas conscientes de 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

Usa lecturas directas del sistema de archivos cuando ya conozcas la ruta y necesites los bytes exactos:

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

Informa qué fuente usaste cuando la frescura o la elección de la bóveda sea relevante.

Flujo de escritura

Elige la ruta de escritura más específica:

  • Nueva nota: obsidian create path="Folder/Note.md" content="...".
  • Añadir/preponer a notas diarias: obsidian daily:append content="...".
  • Ediciones simples de notas: usa apply_patch sobre el archivo Markdown.
  • Renombrar/mover notas: prefiere obsidian move path="Old.md" to="Folder/New.md" para que los enlaces puedan actualizarse.
  • Abrir la UI después de una escritura: añade open solo cuando sea útil o se solicite.

Comandos comunes:

cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"

Para contenido multilínea, prefiere editar el archivo .md con apply_patch una vez que se conozca la ruta. Evita el quoting frágil del shell para texto largo.

Bases, Canvas, Plugins

Usa primero el descubrimiento por 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:

Para archivos .canvas, .base y .json, lee/edita como datos estructurados cuando sea posible. Mantén el formato estable y valida JSON después de las ediciones.

Seguridad

  • No reescribas la bóveda en bloque. Usa rutas específicas y revisa las diferencias.
  • No edites .obsidian/ a menos que el usuario lo pida o la tarea sea explícitamente de configuración/plugins.
  • No elimines notas a menos que se pida explícitamente; prefiere la papelera antes que la eliminación permanente.
  • No crees notas en carpetas ocultas (con punto) a través de la ruta URI/CLI de Obsidian.
  • Conserva el frontmatter y los wikilinks a menos que la tarea sea refactorizarlos.
  • Si existen múltiples bóvedas, no adivines; usa obsidian vaults y 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 relacionados