AI Hub Icon
AIBit Descubre proyectos de código abierto
Inicio / Proyectos Prácticos de Código Abierto

Automatiza las notas de Obsidian con obsidian-skills para Claude & Codex

January 19, 2026
Categoría: Proyectos Prácticos de Código Abierto
Etiquetas:
Automation Obsidian OpenSource Codex ClaudeSkills

Presentación obsidian‑skills

Si estás profundamente inmerso en el ecosistema de Obsidian y también amas a Claude o Codex, querrás que todas tus herramientas se comuniquen entre sí. El proyecto en GitHub

kepano/obsidian-skills

proporciona exactamente eso: una colección de Agent Skills de código abierto desarrollados para Obsidian. Estas habilidades están construidas sobre

  • Especificación Agent Skills (el mismo formato usado por Claude Code y Codex CLI)
  • Tipos de archivos compatibles con Obsidian (Markdown, Obsidian‑Base, JSON‑Canvas)
  • Licencia MIT para reutilización libre y sencilla.

En esta guía explicaremos por qué deberías adoptar el proyecto, cómo instalarlo y un ejemplo práctico de cómo crear una nota con Claude.

¿Qué problema resuelve obsidian‑skills?

  1. Automatización – En lugar de abrir manualmente un nuevo archivo .md, envías una indicación a Claude/Codex y la nota se genera instantáneamente.
  2. Consistencia – Todos los agentes que escriben en Obsidian utilizan el mismo esquema de habilidades, de modo que el formato, los bloques de código y los metadatos se mantienen uniformes.
  3. Multiplataforma – Ya sea que estés en Windows, macOS, Linux o utilices una bóveda basada en la nube, el mismo conjunto de habilidades funciona.

Sin un complemento de habilidades tendrías que: - Editar un archivo a mano - Escribir scripts personalizados fuera de Obsidian - Gestionar las rutas de archivos manualmente en cada agente

Con obsidian‑skills la carga pesada se maneja por ti.

Rutas de Instalación

1. Marketplace de Plugins de Obsidian (recomendado)

  1. En Obsidian, abre Configuraciones → Plugins comunitarios → Buscar.
  2. Busca obsidian‑skills.
  3. Haz clic en Instalar y luego en Habilitar.

Esto instala las habilidades en /.obsidian/plugins/obsidian-skills y las registra automáticamente para su uso por Claude y Codex.

2. Manual (para codex cli o configuraciones locales de Claude)

  • Claude Code – Copia la carpeta completa skills/ al raíz de tu bóveda o a cualquier carpeta que hayas asignado a /.claude.
  • Codex CLI – Coloca la carpeta skills/ en tu directorio ~/.codex/skills.

Después de colocar la carpeta, reinicia tu agente para cargar las nuevas habilidades.

Uso de las Habilidades

Una vez instaladas, las habilidades exponen un conjunto de verbos que el agente puede invocar. Aquí tienes un ejemplo de indicación enviada a Claude:

Indicación 

Use the skill `obsidian-create-note` to create a new note titled "Obsidian‑Skills Demo" with the content:
- Introduction
- How to install
- Quick usage

Resultado – aparece un nuevo archivo Obsidian‑Skills Demo.md en tu bóveda, formateado siguiendo las reglas de Obsidian‑Markdown.

¿Por qué es útil? Te permite redactar actas de reuniones, notas de investigación o listas de tareas por voz o texto, y el archivo está listo instantáneamente para el grafo, retro‑enlaces y complementos de la comunidad de Obsidian.

Comandos Comunes

Habilidad Ejemplo Qué hace
obsidian-create-note Create a new note titled "Project Plan" Crea un archivo .md con un bloque de título
obsidian-edit-note Edit the note "Obsidian‑Skills Demo" to add section “Implementation” Inserta texto en el archivo especificado
obsidian-list-notes List all notes that contain "TODO" Devuelve los nombres de archivo que coinciden con el criterio
obsidian-create-canvas Create a JSON canvas with ID "mindmap" Crea un archivo .canvas para el editor visual de Obsidian

Cada habilidad sigue la Especificación Agent Skills, así que también puedes escribir tus propios envoltorios de habilidades si necesitas un comportamiento muy personalizado.

Extender las Habilidades

Como el repositorio es de código abierto, puedes hacer un fork y añadir nuevas acciones:

  1. Crea una nueva carpeta de habilidad dentro de skills/.
  2. Añade un manifest.json con nombre, descripción y formato de entrada.
  3. Añade un handler.py (Python) o handler.js (JavaScript) que se comunique con el sistema de archivos local de Obsidian.
  4. Haz commit y push. Tu nueva habilidad será accesible para cualquier agente que soporte la especificación.

Las contribuciones de la comunidad son bienvenidas—envía una solicitud de extracción o abre un issue si encuentras errores o deseas nuevas funciones.

Checklist de Inicio

  • Instala desde el marketplace de Obsidian o copia la carpeta a /.claude.
  • Escribe un primer indicación (consulta el ejemplo anterior).
  • Verifica que la nota aparezca y esté correctamente formateada.
  • Explora la lista de habilidades con obsidian-list-notes.
  • Comparte un gist o escribe un tutorial si te entusiasma.

Resumen

Si ya trabajas con Claude, Codex o cualquier agente compatible con Agent Skills, obsidian‑skills es el puente que te permite tratar tus notas como objetos de datos de primera clase. Con solo unos pocos clics desbloqueas:

  • Creación de notas sin intervención
  • Formato Markdown consistente
  • Ediciones rápidas desde voz o chat
  • Integración con el poderoso grafo y ecosistema comunitario de Obsidian

Dirígete a la página de GitHub, da una estrella al repositorio, abre un PR o simplemente comienza a escribir en el chat. ¡Feliz creación de notas!

Artículo original: Ver original

Compartir este artículo