Repolode
Enviar
scaccogatto

scaccogatto/okf-skills

Kit de herramientas de Claude Code para crear, validar, visualizar y mantener paquetes de conocimiento en Markdown del formato OKF (Open Knowledge Format).

Ver en GitHubSitio web
Estrellas
438
Forks
42
Issues abiertos
7
Último commit
anteayer

¿Qué es?

OKF es un formato abierto e independiente de proveedores para almacenar conocimiento sobre un sistema en un directorio de archivos Markdown con YAML frontmatter. Este proyecto permite que Claude Code genere, mantenga, consulte, valide y visualice paquetes OKF como parte de su flujo de trabajo habitual. Incluye un comprobador determinista de conformidad con la especificación, un script de visualización que representa un paquete como un grafo interactivo y una skill para reconstruir un paquete a partir del historial de Git y las transcripciones de sesiones.

El kit de herramientas se distribuye por varios canales: un plugin de Claude Code, agent skills instalables mediante skills.sh, una GitHub Action que valida paquetes en CI sin necesidad de un agente y un servidor MCP de solo lectura con herramientas de búsqueda, lectura y consulta de elementos vecinos. La versión 0.2 del formato incorpora campos de procedencia, confianza y obsolescencia, que las herramientas pueden leer y a los que pueden migrar desde la versión 0.1.

El repositorio cuenta con licencia MIT e incluye la especificación OKF v0.2 vendorizada, un paquete de ejemplo disponible en una demo en vivo y experimentos de benchmark con sus protocolos y resultados.

Funciones clave

  • 01Genera y mantiene paquetes de conocimiento OKF a partir de la especificación vendorizada y de plantillas.
  • 02Valida los paquetes según la especificación con modos estrictos y de umbral de advertencias, además de permitir la salida en JSON.
  • 03Representa un paquete como un grafo HTML interactivo y autocontenido, con insignias de confianza y obsolescencia.
  • 04Reconstruye un paquete a partir del historial de Git y de las transcripciones de sesiones de Claude.
  • 05Incluye un servidor MCP de solo lectura que ofrece herramientas de búsqueda, lectura y consulta de elementos vecinos.
  • 06Incluye una GitHub Action para validar paquetes en CI.

Casos de uso

  • Documentar la arquitectura y las decisiones de un servicio en archivos Markdown versionados junto al código.
  • Proporcionar a los agentes de programación contexto estructurado del proyecto que puedan consultar y citar.
  • Validar automáticamente paquetes de conocimiento en CI antes de fusionar cambios.
  • Reconstruir la documentación de un proyecto para un repositorio que no tenga ningún paquete existente.

Inicio rápido

  1. 1

    Añade el marketplace en Claude Code

    /plugin marketplace add scaccogatto/okf-skills
  2. 2

    Instala el plugin okf

    /plugin install okf@scaccogatto
  3. 3

    Documenta un proyecto en OKF pidiéndole a Claude que genere un bundle

    /okf:okf produce .okf
  4. 4

    Valida el bundle antes de hacer commit

    /okf:validate .okf --strict

Antes de usarlo

  • La cadena de herramientas completa está diseñada para Claude Code; otros agentes solo disponen de las skills, sin subagentes de backfill.
  • Los scripts necesitan uv o python3 con pyyaml instalado.
  • El proyecto aún es anterior a la versión 1.0, por lo que la etiqueta de acción @v1 puede cambiar entre versiones.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceServidores MCPBibliotecas de skills para agentes de IAGeneradores de sitios estáticos y herramientas de documentación

Temas

#claude-code#knowledge-management#markdown#yaml#agent-skills#llm-tools#mcp#knowledge-graph#ai-agents#claude-code-plugin

Preguntas frecuentes

¿Qué es okf-skills?
Kit de herramientas de Claude Code para crear, validar, visualizar y mantener paquetes de conocimiento en Markdown del formato OKF (Open Knowledge Format). OKF es un formato abierto e independiente de proveedores para almacenar conocimiento sobre un sistema en un directorio de archivos Markdown con YAML frontmatter. Este proyecto permite que Claude Code genere, mantenga, consulte, valide y visualice paquetes OKF como parte de su flujo de trabajo habitual. Incluye un comprobador determinista de conformidad con la especificación, un script de visualización que representa un paquete como un grafo interactivo y una skill para reconstruir un paquete a partir del historial de Git y las transcripciones de sesiones.
¿okf-skills es gratuito? ¿Qué licencia tiene?
okf-skills es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿okf-skills sigue mantenido?
Mantenimiento activo. El último commit de okf-skills fue el 4 nov 2026.
¿Para qué puedo usar okf-skills?
Documentar la arquitectura y las decisiones de un servicio en archivos Markdown versionados junto al código. Proporcionar a los agentes de programación contexto estructurado del proyecto que puedan consultar y citar. Validar automáticamente paquetes de conocimiento en CI antes de fusionar cambios. Reconstruir la documentación de un proyecto para un repositorio que no tenga ningún paquete existente.
¿Cómo se instala okf-skills?
Añade el marketplace en Claude Code: /plugin marketplace add scaccogatto/okf-skills Instala el plugin okf: /plugin install okf@scaccogatto Documenta un proyecto en OKF pidiéndole a Claude que genere un bundle: /okf:okf produce .okf Valida el bundle antes de hacer commit: /okf:validate .okf --strict
¿Dónde consigo okf-skills?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/scaccogatto/okf-skills

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados