obsidian-reading-guardrails

AlejandroIglesiasCalvo's avatarfrom AlejandroIglesiasCalvo

Garantiza lectura real, control de limites, registro en cache y validacion de citas/wikilinks en Obsidian.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads
[Knowledge Base]

When & Why to Use This Skill

Obsidian Reading Guardrails is a specialized Claude skill designed to ensure high-fidelity information retrieval and data integrity within Obsidian vaults. It eliminates AI hallucinations by enforcing strict reading protocols, validating wikilinks, and maintaining a persistent cache of processed notes. By implementing configurable reading limits and verifiable citation tracking, it guarantees that every response is grounded in actual vault content, providing a reliable bridge between LLMs and personal knowledge management systems.

Use Cases

  • Reliable Summarization: Summarize extensive Obsidian notes with the assurance that the agent has performed a full read or targeted section analysis, preventing the omission of critical details.
  • Automated Link & Citation Auditing: Verify the existence and accuracy of internal wikilinks ([[...]]) and transclusions (![[...]]) to maintain a healthy and interconnected knowledge graph.
  • Large-Scale Vault Navigation: Manage context windows effectively using soft and hard reading limits (KB-based), allowing the agent to handle large files without exceeding token constraints.
  • Traceable Research: Generate reports or answers with a 'Sources' section that includes verified hashes and timestamps, ensuring all claims are backed by specific documents in the vault.
  • Hallucination Prevention: Force the agent to declare 'not found in vault' if a source cannot be fully read or verified, maintaining a high standard of factual accuracy.
nameobsidian-reading-guardrails
description"Garantiza lectura real, control de limites, registro en cache y validacion de citas/wikilinks en Obsidian."

Obsidian Reading Guardrails

Cuando usar

  • Tengo que leer notas para responder, resumir o editar.
  • Necesito trazabilidad y citas verificables.
  • Quiero evitar alucinaciones por lecturas incompletas.

Guardrails

  • Si no puedo leer una fuente necesaria, digo "no consta en la boveda".
  • No cito nada que no haya leido completo.
  • Mantengo un registro de lecturas con hash y tamano.

Procedimiento

  1. Definir objetivos
    • Identifico las rutas objetivo y el alcance (nota principal + enlaces de primer nivel).
  2. Lectura completa o limitada
    • Si el archivo supera limite_lectura_suave_kb (128 KB por defecto), leo secciones objetivo.
    • Si supera limite_lectura_duras_kb (512 KB por defecto), pido confirmacion para leer completo.
  3. Seguir enlaces de primer nivel
    • Wikilinks [[...]], transclusiones ![[...]].
    • Enlaces Markdown a .md/.txt/.pdf cuando sean parseables.
  4. Registrar lecturas
    • Escribo en cache/lecturas.json (o la ruta de cache del vault) con hash, tamano y enlaces seguidos.
  5. Anclado minimo
    • Si necesito citar un bloque sin ^ancla, propongo anadir una ancla solo con aprobacion.
  6. Validar wikilinks
    • Verifico existencia de nota y seccion.
    • Si una seccion falla, degrado la cita a nivel de nota y lo marco.

Formato de registro (ejemplo)

{
  "ruta": "ruta/nota.md",
  "timestamp": "YYYY-MM-DDTHH:mm:ss",
  "tamano": 12345,
  "hash": "sha256:...",
  "origen": "filesystem",
  "enlaces_seguidos": ["ruta/enlace.md"]
}

Entrega

  • Incluyo una seccion Fuentes internas con wikilinks precisos.
  • Si falta lectura, detengo la entrega y declaro "no consta en la boveda".