agentleFS
seoutopicoseoutopico/pm_claude_code/.claude/skills/wiki-lint/SKILL.md

wiki-lint

Skill4 starsChanged 6 months agoMITView on GitHub

Health check del sistema. Detecta contradicciones entre memoria y proyectos, páginas huérfanas, gaps de información, referencias rotas. Trigger con "lint", "salud del sistema", "/lint".

42 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use wiki-capture, wiki-status and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • jehrhardtSkill

    wiki-capture

    Quickly capture raw thoughts, links, images, or notes to today's Obsidian daily note from anywhere in Pi. Use when the user wants to jot something down for later wiki processing.

    Also in 6 projects that use this

  • nexuschainsSkill

    wiki-status

    Reports the current state of the wiki vault — page counts, category breakdown, hub pages, orphans, stale entries, and a delta showing what has changed since the last ingest. Use this skill when the operator asks "what's the status", "wiki dashboard", "how many pages", "what's stale", "what's been ingested", "show me the delta", or "wiki health overview". Also surfaces structural insights (top hubs, fragmented clusters, bridge pages) when the operator asks "wiki insights", "what's central", or "show me the hubs". Read-only: this skill reports and recommends; it does not modify any files.

    Also in 5 projects that use this

  • nexuschainsSkill

    cross-linker

    Scans the wiki vault and adds missing [[wikilinks]] between pages that are related but not yet connected. Use this skill when the operator says "link my pages", "find missing links", "cross-reference the wiki", "connect my wiki", "add wikilinks", or after any large ingest to weave new pages into the existing knowledge graph. Also trigger when orphaned pages need connecting or when wiki-lint reports fragmented tag clusters. This is a write-heavy skill — it modifies page files to insert links, unlike wiki-lint which only reports.

    Also in 4 projects that use this

  • Ivy-Chen1999Skill

    wiki-synthesize

    Systematically discover synthesis opportunities across the Obsidian wiki — pairs or clusters of concepts that co-occur frequently across pages but have no synthesis page connecting them. Creates new synthesis/ pages that draw explicit cross-cutting conclusions. Use when the user says "synthesize my wiki", "find connections", "what concepts keep coming up together", "/wiki-synthesize", or after a large ingest when the vault has grown significantly.

    Also in 4 projects that use this

  • Ivy-Chen1999Skill

    wiki-setup

    Initialize a new Obsidian wiki vault with the correct structure, special files, and configuration. Use this skill when the user wants to set up a new wiki from scratch, initialize the vault structure, create the .env file, or says things like "set up my wiki", "initialize obsidian", "create a new vault", "get started with the wiki". Also use when the user needs to reconfigure their existing vault or fix a broken setup.

    Also in 5 projects that use this

  • bozhouDevSkill

    wiki-init

    Use when bootstrapping a new personal wiki for any knowledge domain — research, codebase documentation, reading notes, competitive analysis, or any long-term knowledge accumulation project.

    Also in 7 projects that use this

  • +1 more from nexuschains
  • +4 more from Ivy-Chen1999

The file

Files
SKILL.md

Skill: Wiki lint

Cuándo se activa

Cuando el usuario lanza /lint, pide "comprueba la salud del sistema", "busca inconsistencias", "auditoría", o periódicamente como parte de la rutina (recomendado: semanal).

Qué hace

Recorre el sistema completo (_memory/, _projects/, _inbox/) buscando problemas. Reporta. No corrige automáticamente: el usuario decide qué arreglar.

Patrón inspirado en el Lint del LLM Wiki de Karpathy.

Qué busca

Contradicciones

  • Un proyecto en _projects/<id>/README.md dice Estado: Cancelado pero _memory/projects.md lo lista como activo.
  • _memory/_registry.json desactualizado respecto a los READMEs.
  • STATUS.md con fechas o estados que no coinciden con los proyectos.

Páginas huérfanas

  • Proyecto en _projects/ que no aparece en _memory/projects.md ni en _registry.json.
  • Persona mencionada en varios proyectos pero sin entrada en _memory/people.md.
  • Decisión mencionada (D-NNN) en un proyecto pero ausente en _memory/decisions.md.

Gaps

  • Proyecto sin reuniones desde hace más de 30 días pero con estado "En curso".
  • Proyecto con bloqueos sin resolver desde hace más de 14 días.
  • Inbox no procesado con notas pendientes desde hace más de 7 días.

Estructura

  • Carpetas de proyecto sin README.md.
  • READMEs sin sección de estado o sin próximo hito.
  • Plantillas modificadas sin {{placeholders}} (señal de uso accidental como proyecto).

Memoria

  • _memory/log.md sin entradas en los últimos 14 días pero con cambios en proyectos (señal de que el log no se mantiene).
  • Entradas del log sin formato ## [YYYY-MM-DD] parseable.

Cómo proceder

  1. Recorre el sistema con Glob y Grep. No leas archivos completos si no hace falta — busca patrones específicos.
  2. Agrupa hallazgos por categoría (Contradicciones, Huérfanas, Gaps, Estructura, Memoria).
  3. Prioriza: Críticas (contradicciones de estado, datos perdidos) > Medias (gaps, huérfanas) > Bajas (formato).
  4. Reporta al usuario una tabla:
    | Severidad | Categoría | Hallazgo | Cómo arreglarlo |
    |---|---|---|---|
  5. No arregles automáticamente. Sugiere qué comando o acción manual lo resuelve.
  6. Añade al log:
    ## [YYYY-MM-DD] lint | <N> hallazgos (C: X, M: Y, B: Z)

Output esperado

Una tabla agrupada por severidad, con cada hallazgo + cómo arreglarlo. Si todo está limpio, un mensaje corto "Sistema sano".

Reglas

  • Solo reporta, no toca nada (excepto añadir al log).
  • Sugiere comandos concretos (/status-refresh, /ingesta, "edita manualmente X") en lugar de descripciones vagas.
  • Si encuentras algo que no entiendes, listalo en una sección "Requiere revisión humana" en vez de adivinar.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.