CommunityProgramación y desarrollogithub.com

BorjaGM1/kb-template

Linpia y ordena los vaults (enlaces rotos, huérfanos, duplicados, notas obsoletas, etiquetas, MOC) y genera un informe. Las eliminaciones requieren la aprobación del propietario.

¿Qué es kb-template?

Esta habilidad automatiza el mantenimiento de un jardín de conocimiento personal basado en archivos de texto plano (un vault de notas) dentro de un repositorio Git. Ejecuta scripts para detectar y corregir automáticamente enlaces rotos, notas huérfanas, duplicados, notas obsoletas, problemas de etiquetas y de frontmatter, y organiza las notas de la bandeja de entrada. Genera un informe de todas las acciones realizadas y las propuestas que requieren aprobación del propietario (como fusiones o eliminaciones). Está diseñado para plataformas como Obsidian, Foam o cualquier vault de Markdown, y funciona ejecutando un script de Python y siguiendo una serie de pasos definidos en el SKILL.md.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorjaGM1/kb-template/tree/HEAD/skills/gardening

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Jardinería

  1. Desde la raíz del repositorio: git pull --rebase.
  2. Ejecuta python3 scripts/lint.py (todos los vaults) y recoge la salida.
  3. Enlaces rotos: corrige errores tipográficos/renombres apuntando a la nota existente; si el destino realmente falta, crea un stub solo si es útil, de lo contrario desvincula. Nunca inventes contenido.
  4. Huérfanos: enlaza cada huérfano desde una nota relacionada o MOC; si no encaja, muévelo a Inbox/.
  5. Duplicados: encuentra títulos/alias/contenido similares (rg, comparar). Fusiona en la nota mejor (conserva todos los datos, unión de fuentes, añade alias, redirige enlaces). Las fusiones que eliminen contenido o archivos: propón, no hagas.
  6. Notas obsoletas: updated > 6 meses, stubs vacíos, proyectos terminados: propón status: archived o eliminación.
  7. Etiquetas: normaliza mayúsculas/kebab-case, fusiona sinónimos (#ideas a #idea), elimina etiquetas ruidosas de un solo uso.
  8. Frontmatter: asegura que created/updated/source/tags estén presentes y sean válidos.
  9. Bandeja de entrada: archiva notas de Inbox/ en el lugar correcto cuando esté claro.
  10. MOC: mantén actualizados Home.md y los MOC temáticos; crea un MOC cuando un tema alcance ~5 notas.
  11. Vuelve a ejecutar lint; confirma por cambio lógico (garden(<v>): ...); empuja inmediatamente después de cada uno.
  12. Informe al propietario: lo que se arregló, más las propuestas de eliminación/fusión/archivo que necesitan aprobación. Nunca elimines sin la aprobación del propietario.

Individual skills in this repo

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

Skills relacionados