📥 Skill: Vault Ingest (Guardado y Clasificación)
Objetivo de la Skill
Contrato único para guardar cualquier información en Ryukami Labs: decide carpeta, nombre, frontmatter, tags, deduplicación, backlinks y validación. Es la skill que se activa cuando el usuario dice “guarda esto”, “documenta esto” o “¿dónde va?”.
Regla de oro
Primero buscar, luego decidir, después escribir, al final enlazar y validar. Si hay duplicado, se actualiza; no se crea otra nota.
📋 Cuándo Activar esta Skill
- El usuario pasa información de cualquier tipo y pide guardarla.
- Hay que decidir en qué carpeta va una nota nueva.
- Hay que actualizar una nota existente sin duplicarla.
- Hay que normalizar frontmatter, nombres o tags.
- Se quiere capturar algo rápido sin clasificar (
01_Inbox).
🗂️ Routing Rápido
| Info | Destino | tipo |
|---|---|---|
| Idea suelta / sin clasificar | 01_Inbox/ | inbox |
| IA: concepto, modelo, paper | 03_Conocimiento/Inteligencia Artificial/ | concepto |
| IA: tutorial con pasos | 03_Conocimiento/Inteligencia Artificial/ | guia |
| Linux, terminal, hardware, ADB | 03_Conocimiento/Linux & Sistema/ | guia |
| Framework, CLI, SaaS dev | 03_Conocimiento/Web Dev & Herramientas/ | guia-herramienta |
| A11y y auditoría | 03_Conocimiento/Accesibilidad & Auditoria/ | guia |
| Skills, agentes, prompts | 03_Conocimiento/Skills & Agentes/ | skill / recurso |
| Proyecto de código | `04_Proyectos/Proyectos Privados | Publicos/` |
| Curso / apunte | 04_Proyectos/Curso Dev Env/ | curso |
| Personal / trámites | 05_Personal/ | personal |
| Bitácora del día | 06_Diario/YYYY-MM-DD.md | diario |
| Assets | 02_Meta/Assets/ | — |
La tabla completa, la taxonomía cerrada y los ejemplos están en .agents/skills/vault-ingest/SKILL.md.
🛠️ Procedimiento
- Clasificar con la tabla de routing.
- Deduplicar:
lsde la carpeta +rg -il "clave" --glob '*.md' . - Escribir con frontmatter canónico (
title,tipo,estado,tags,creado,actualizado). - Enlazar únicamente desde
index.md(MOC raíz).02_Meta/Home.mdes portada y no se edita. - Validar con
validate_vault_note.py. Criterio: 0 errores.
⚠️ Reglas y Restricciones
- ❌ No inventar valores de
tipofuera de la taxonomía cerrada. - ❌ No renombrar, mover ni borrar notas sin confirmación.
- ❌ No crear carpetas nuevas sin confirmación.
- ❌ No guardar secretos, tokens ni claves.
- ❌ No hacer
git commit/pushsin pedido explícito. - ✅ Si falta un dato:
por confirmar, nunca inventarlo.
🔗 Referencias
- Skill operativa:
.agents/skills/vault-ingest/SKILL.md - Contrato del agente:
AGENTS.md(raíz de la bóveda) - Diseño visual: Obsidian Scorch Design (v4.1)
- Validador:
.agents/skills/obsidian-scorch-design/scripts/validate_vault_note.py