# Wiki Lint

> Ejecuta una comprobación de salud determinista y de solo lectura sobre una wiki de Obsidian. Informa de grafo, enlaces, frontmatter, ledger de procedencia e índices desactualizados; no repara archivos.

Fuente: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki-lint
Markdown: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki-lint.md

Repositorio: https://github.com/AgriciDaniel/claude-obsidian
Autor: AgriciDaniel
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 85 tok instalada, 757 tok al activarse, 757 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent claude-code
# Cursor
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent cursor
# Codex
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent codex
# Gemini CLI
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent gemini
# Windsurf
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent windsurf
# Cline
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-lint --agent cline
```

## Qué hace

- Ejecuta una comprobación de salud determinista y de solo lectura sobre un vault de Obsidian
- Detecta enlaces muertos o ambiguos, páginas huérfanas, huecos de frontmatter obligatorio, secciones vacías e índices desactualizados
- Nunca repara archivos automáticamente; la reparación es una transacción aparte, revisada y aplicada tras la aprobación
- Informa solo de las comprobaciones y conteos presentes en la salida del motor, sin análisis semántico o de prosa

## Cuándo usarla

- Se pide un lint, auditoría de salud del vault, buscar enlaces rotos u orfandades, o auditar frontmatter y procedencia
- Se necesita un informe determinista antes de decidir qué reparar

## Cuándo no

- No razona de forma amplia ni repara archivos por sí mismo

## Qué la activa

- "Haz un lint de mi vault de Obsidian"
- "Busca notas huérfanas y enlaces rotos"
- "Audita la salud del wiki"

## Antes de instalar

- Necesita el core `claude-obsidian.py` instalado y un vault de Obsidian resuelto; no requiere acceso a la red.
- Necesita en el PATH: python3
- Variables de entorno: CORE, PRODUCT_ROOT, VAULT
- reads environment config

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde AgriciDaniel/claude-obsidian bajo MIT. Esta sección es el documento original y está en inglés.

# Lint the wiki

Use the portable lint engine as the source of truth. Lint observes vault state;
it does not create reports, dashboards, canvases, stubs, or fixes.

Resolve the installed product root from this skill's own location, not from the
vault or current working directory:

```bash
PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
test -f "$CORE"
```

## Run

Resolve the user vault, then run one of:

```bash
python3 "$CORE" lint --vault "$VAULT"
python3 "$CORE" lint --vault "$VAULT" --format markdown
```

Use `--strict` only when a nonzero exit for findings is useful in automation.
The command remains read-only either way.

The deterministic parser understands Obsidian wikilinks and embeds, Markdown
links, aliases, heading and block fragments, escaped aliases, and code fences.
It reports such categories as dead or ambiguous links, orphan pages, required
frontmatter gaps (including `title`), empty sections, stale index entries, and
source/claim ledger contract violations. Report only the
checks and counts present in its output; do not claim that it performed
semantic, stylistic, or prose-level contradiction analysis when it did
not.

## Explain findings

1. Preserve the engine's paths, line numbers, targets, categories, and counts.
2. Group findings by likely impact: broken navigation, ambiguous resolution,
   metadata quality, then maintainability.
3. Explain that an orphan may be intentional and an ambiguous basename needs a
   path-qualified link; do not infer intent from the finding alone.
4. Treat allowlisted findings as policy, not as proof that the target exists.
5. Separate deterministic facts from suggested remediation.

Do not write the Markdown rendering into the vault. Return it in chat or stdout.

## Repair is a separate operation

Never auto-fix a lint result. After the user chooses specific findings to
repair:

1. Re-read each target and record its expected SHA-256.
2. Draft only the selected changes; do not delete or merge pages without
   explicit consent.
3. Build one repair bundle with a new operation ID.
4. Inspect the bundle and show exact changed paths.
5. Apply only after that separate review.
6. Re-run lint read-only and compare the relevant findings.

Follow the [operation transaction contract](../wiki/references/operation-transactions.md).
Lint itself never applies that transaction and never commits Git.

## Checkpoint

Observe the deterministic report, think about root causes rather than finding
count, verify proposed repairs against current hashes, and grow by improving the
workflow that produced repeated findings.

## Dónde encaja

- Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales.
- Creador: [AgriciDaniel](https://skillsagentes.com/creators/agricidaniel.md) — 46 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Wiki](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki.md): Inicializa, adopta y enruta el trabajo hacia un vault de Obsidian separado a través del core portátil `claude-obsidian`. Para configurar el vault o elegir el sub-skill correcto.
- [Defuddle](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/defuddle.md): Planifica y, con consentimiento explícito de red, usa un limpiador externo Defuddle opcional para extraer páginas HTTPS tipo artículo como Markdown.
- [Obsidian Bases](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-bases.md): Explica, redacta y valida archivos Obsidian Bases `.base` con filtros, fórmulas, propiedades, resúmenes y vistas de tabla, tarjetas o lista.
- [Obsidian Markdown](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-markdown.md): Explica, redacta o valida la sintaxis de Obsidian Flavored Markdown: propiedades, wikilinks, embeds, callouts, tags, comentarios, resaltados, referencias de bloque, matemáticas y Mermaid.
- [Canvas](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/canvas.md): Crea, inspecciona y actualiza tableros Obsidian JSON Canvas con nodos de texto, archivo, enlace, grupo y arista. Para estado del canvas, mapas visuales, zonas y diseños espaciales.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)