Lista todas las notas (.md) en el vault o en una carpeta específica

Args: carpeta: Carpeta específica a explorar (vacío = raíz del vault) incluir_subcarpetas: Si incluir subcarpetas en la búsqueda

Lee el contenido completo de una nota especifica

Args: nombre_archivo: Nombre del archivo (ej: "Diario/2024-01-01.md")

Busca texto en las notas del vault usando búsqueda inteligente (ripgrep o fallback Python). Soporta múltiples términos: "nas ssh" buscará notas que contengan "nas" Y "ssh".

Args: texto: Texto a buscar (puede incluir múltiples palabras) carpeta: Carpeta específica donde buscar (vacío = todo el vault) solo_titulos: Si buscar solo en los títulos de las notas

Busca notas modificadas en un rango de fechas

Args: fecha_desde: Fecha de inicio (YYYY-MM-DD) fecha_hasta: Fecha de fin (YYYY-MM-DD, opcional, por defecto hoy)

Mueve o renombra una nota dentro del vault.

Args: origen: Ruta relativa actual de la nota (ej: "Sin titulo.md") destino: Ruta relativa nueva de la nota (ej: "01_Inbox/Nueva Nota.md") crear_carpetas: Si crear las carpetas destino si no existen (True)

Returns: Mensaje de exito o error.

Extrae un concepto aleatorio del vault como flashcard sorpresa. Util para reforzar conocimiento o descubrir notas olvidadas.

Args: carpeta: Carpeta especifica donde buscar (vacio = todo el vault)

Lista las plantillas disponibles en la carpeta ZZ_Plantillas.

Returns: Lista de nombres de plantillas disponibles.

Sugiere carpetas candidatas para una nota nueva según su contenido y tags.

⚠️ IMPORTANTE PARA AGENTES DE IA: ⚠️ Esta herramienta devuelve SUGERENCIAS PROBABILÍSTICAS, no respuestas definitivas. Debes:

1. Evaluar las opciones junto con el contexto del usuario.

2. Considerar la confianza (confidence) de cada sugerencia.

3. Proponer la mejor opción al usuario, explicando tu razonamiento.

4. Si ninguna sugerencia tiene alta confianza (>0.5), preguntar al usuario.

La sugerencia se basa en notas similares ya existentes en el vault. No es infalible: el usuario puede tener una mejor idea de dónde ubicarla.

Args: titulo: Título de la nota. contenido: Fragmento o contenido total de la nota. etiquetas: Etiquetas enviadas o planeadas.

Returns: Lista de carpetas sugeridas con confianza, o fallback a reglas.

Crea una nueva nota en el vault.

⚠️ ADVERTENCIA CRÍTICA PARA AGENTES DE IA: ⚠️

1. NO uses herramientas genéricas de sistema de archivos (como write_file). SIEMPRE usa esta herramienta para crear notas en el vault.

2. ANTES de ejecutar esta acción, DEBES haber leído las reglas globales con leer_contexto_vault y obtener_reglas_globales.

3. Verifica si existe una SKILL aplicable (ej: investigador, escritor) y sigue sus instrucciones específicas.

Args: titulo: Título de la nota. contenido: Contenido de la nota. carpeta: Carpeta donde crear la nota (vacío = raíz). etiquetas: Etiquetas separadas por comas. plantilla: Nombre del archivo de plantilla (ej: "Diario.md"). agente_creador: Si se creó usando un agente específico (ej: "escritor"). descripcion: Descripción breve de la nota (para placeholder {{description}}).

Agrega contenido a una nota existente.

Args: nombre_archivo: Nombre del archivo a modificar. contenido: Contenido a agregar. al_final: Si agregar al final (True) o al principio (False) de la nota.

Returns: Un mensaje indicando el resultado de la operación.

Elimina una nota del vault (requiere confirmación).

Args: nombre_archivo: Nombre del archivo a eliminar. confirmar: Confirmación para eliminar (debe ser True).

Returns: Un mensaje indicando el resultado de la operación.

Edita una nota existente, reemplazando todo su contenido.

⚠️ ADVERTENCIA CRÍTICA PARA AGENTES DE IA: ⚠️

1. NO uses herramientas genéricas de sistema de archivos.

2. ANTES de ejecutar, DEBES leer la nota original con leer_nota.

3. DEBES respetar las Reglas Globales (sin emojis en títulos, frontmatter válido).

4. El nuevo contenido debe ser TOTAL (no diffs).

Args: nombre_archivo: Nombre o ruta de la nota a editar (ej: "Mi Nota.md") nuevo_contenido: El contenido completo actualizado (incluye frontmatter YAML)

Returns: Mensaje de confirmación o error

Busca y reemplaza texto en todas las notas del vault. Útil para corregir enlaces rotos, renombrar tags, o actualizar rutas.

Args: buscar: Texto o patrón a buscar (texto literal, no regex). reemplazar: Texto de reemplazo. carpeta: Carpeta específica donde buscar (vacío = todo el vault). solo_preview: Si True, solo muestra qué cambiaría sin modificar. limite: Máximo de archivos a procesar (seguridad).

Returns: Resumen de archivos afectados y cambios realizados.

Captura rápida de una idea al Inbox sin fricción.

Crea una nota en la carpeta Inbox (00_Bandeja) con timestamp automático. Ideal para "guardar esto rápido" sin pensar en ubicación o formato.

Args: texto: El contenido a capturar. etiquetas: Etiquetas opcionales separadas por comas.

Returns: Confirmación con la ruta de la nota creada.

Añade contenido debajo de una sección específica de una nota.

Busca el heading de la sección y añade el contenido justo antes del siguiente heading del mismo nivel o superior.

Args: nombre_archivo: Nombre de la nota a modificar. seccion: Nombre de la sección (ej: "Recursos", "## Ideas"). contenido: Contenido a insertar. crear_si_no_existe: Si True, crea la sección si no existe.

Returns: Confirmación del contenido añadido.

Genera estadísticas completas del vault de Obsidian

Obtiene la lista de tags oficiales/canónicas definidas en el archivo 'Registro de Tags del Vault.md'.

Returns: Lista de tags categorizadas según el registro oficial.

Analiza el uso de etiquetas en el vault.

Sincroniza el uso de tags en el vault con el registro oficial.

Args: actualizar: Si es True, intenta actualizar la tabla de estadísticas en el archivo de registro.

Obtiene una lista simple de las etiquetas existentes en el vault. Útil para ver qué etiquetas ya existen antes de crear nuevas.

Returns: Lista de etiquetas formateada como string.

Analiza los enlaces internos en el vault

Genera un resumen de la actividad reciente en el vault

Args: dias: Número de días hacia atrás para analizar (por defecto 7)

Obtiene todas las notas que enlazan a la nota especificada (backlinks).

Args: nombre_nota: Nombre de la nota (con o sin .md)

Returns: Lista de notas que contienen enlaces a esta nota

Busca todas las notas que contienen una etiqueta específica.

Args: tag: Etiqueta a buscar (con o sin #)

Returns: Lista de notas que contienen la etiqueta

Obtiene el grafo local de una nota: enlaces salientes y entrantes.

Args: nombre_nota: Nombre de la nota central profundidad: Niveles de profundidad (1 = solo conexiones directas)

Returns: Visualización del grafo local de la nota

Encuentra notas huérfanas: sin enlaces entrantes ni salientes.

Returns: Lista de notas que no están conectadas al grafo del vault

Obtiene la transcripción de un video de YouTube.

Args: url: URL del video de YouTube o ID del video. language: Código del idioma opcional (ej: 'es', 'en'). Si se omite, busca subtítulos manuales en el idioma original, o falla al autogenerado del video.

Returns: El texto completo de la transcripción o un mensaje de error.

Lee la estructura general del vault y estadísticas clave.

⚠️ OBLIGATORIO PARA AGENTES DE IA: ⚠️ Esta debe ser SIEMPRE la PRIMERA herramienta que ejecutes al comenzar cualquier tarea con el vault. Te informa de:

1. Estructura de carpetas válida.

2. Plantillas disponibles.

3. Estado de la configuración de Agentes (.agent).

Devuelve un resumen de carpetas, plantillas y etiquetas comunes.

Lista las skills (agentes) disponibles en el vault.

Obtiene el contenido de una Skill específica (SKILL.md).

Args: nombre: El nombre de la carpeta de la skill (ej: 'escritor').

Obtiene las reglas globales del Agente (.agent/REGLAS_GLOBALES.md).

⚠️ OBLIGATORIO PARA AGENTES DE IA: ⚠️ DEBES leer estas reglas ANTES de realizar cualquier escritura o modificación en el vault. Contienen restricciones críticas (ej: NO emojis, formatos permitidos).

Invalida y refresca el caché de skills (úsalo tras editar SKILL.md).

Genera una nueva skill con estructura consistente.

Crea automáticamente el archivo SKILL.md con:

• Frontmatter YAML correcto

• Referencia a REGLAS_GLOBALES

• Sección "REGLA DE ORO DE EDICIÓN"

Args: nombre: Identificador de la skill (ej: "profesor-fisica"). descripcion: Descripción breve de lo que hace la skill. instrucciones: Instrucciones principales en markdown. herramientas: Herramientas separadas por comas (ej: "read, edit, web"). ubicacion_defecto: Carpeta por defecto para notas (ej: "02_Aprendizaje/").

Analiza el vault y sugiere skills personalizadas.

Escanea patrones de uso: tags frecuentes, carpetas con más contenido, tipos de notas. Devuelve sugerencias de skills basadas en tu vault.

Sincroniza y valida las skills existentes.

Detecta problemas como:

• Falta de referencia a REGLAS_GLOBALES

• Falta de sección "REGLA DE ORO DE EDICIÓN"

• Frontmatter incorrecto

Args: actualizar: Si True, aplica correcciones. Si False, solo reporta.