agentleFS
MauricioPereraMauricioPerera/repo-as-an-agent/.agents/skills/okf-librarian/SKILL.md

okf-librarian

Skill0 starsChanged 24 days agoMITView on GitHub

Creates, updates, links, and validates structured memory nodes inside knowledge/ following the Open Knowledge Format (OKF) specification. Use this skill whenever storing durable project knowledge, business rules, glossaries, client notes, or decisions, or when okf-lint.sh reports validation errors.

The file

Files
SKILL.md

Curaduría de Memoria en Open Knowledge Format (okf-librarian)

La carpeta knowledge/ es la memoria duradera, legible por humanos y versionada en Git de este espacio. Todo cambio en knowledge/ es auditado automáticamente por okf-lint.sh en cada punto de guardado.

Reglas Estrictas del Estándar OKF

  1. Carga Progresiva: Siempre lee primero index.md antes de recorrer subcarpetas completas.
  2. Archivos Estructurales Reservados:
    • knowledge/index.md y knowledge/log.md (y cualquier index.md/log.md en subdirectorios) son archivos estructurales.
    • Prohibido asignarles type: de concepto en un YAML frontmatter.
  3. Documentos de Concepto (knowledge/<dominio>/<concepto>.md):
    • Usa nombres en minúsculas con guiones (acuerdos-precios.md, glosario-legal.md).
    • Todo concepto DEBE iniciar en la línea 1 con YAML frontmatter válido:
      ---
      type: '<Tipo de Concepto>'          # OBLIGATORIO: ej. 'Glossary', 'Decision Record', 'Client Profile', 'Playbook'
      title: '<Título legible>'           # OBLIGATORIO en esta plantilla
      description: '<Resumen en 1 línea>' # OBLIGATORIO en esta plantilla
      tags: ['<tag1>', '<tag2>']          # Recomendado
      timestamp: '<ISO-8601>'             # Recomendado
      ---
    • Debe contener al menos un bloque de contenido Markdown claro después del cierre ---.
    • El perfil YAML admite mapas planos, escalares de una línea y listas de escalares en línea. Cierra todas las comillas y listas; no repitas claves. Los mapas anidados, bloques multilínea, etiquetas y alias se rechazan. Los campos obligatorios no pueden ser nulos ni listas.
  4. Grafo de Enlaces Relativos:
    • Conecta conceptos relacionados usando enlaces Markdown relativos reales (ej. [Perfil del Espacio](../profile/context.md)).
    • Nunca dejes enlaces rotos: okf-lint.sh verifica físicamente cada ruta enlazada.

Flujo de Trabajo Paso a Paso

  1. Revisa index.md para comprobar si ya existe un nodo sobre ese tema (actualízalo en lugar de duplicarlo).
  2. Crea o edita el nodo <concepto>.md dentro de una subcarpeta temática adecuada (ej. knowledge/dominio/, knowledge/clientes/, knowledge/decisiones/).
  3. Si creaste un concepto nuevo, enlázalo en index.md.
  4. Registra una entrada breve con fecha en log.md describiendo qué aprendió o actualizó el espacio.
  5. Validación determinista obligatoria: Ejecuta siempre:
    sh .agents/scripts/okf-lint.sh
    Asegúrate de obtener OKF_LINT_STATUS=PASS antes de crear un punto de guardado. El control de guardado valida automáticamente la versión preparada con okf-lint.sh --staged, incluyendo los destinos de enlaces; una corrección solo en disco no sustituye la versión preparada.

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.