scaccogatto/okf-skills

O que é?

Recursos principais

• 01Gera e mantém bundles de conhecimento OKF com base na especificação vendorizada e em templates.
• 02Valida bundles conforme a especificação, com modos estrito e de limite de avisos, além de saída em JSON.
• 03Renderiza um bundle como um grafo interativo em HTML independente, com indicadores de confiança e desatualização.
• 04Reconstrói um bundle com base no histórico do Git e em transcrições de sessões do Claude.
• 05Disponibiliza um servidor MCP somente leitura com ferramentas de busca, leitura e consulta de vizinhos.
• 06Inclui uma GitHub Action para validar bundles no CI.

Casos de uso

• Documentar a arquitetura e as decisões de um serviço em arquivos Markdown versionados junto ao código.
• Fornecer aos agentes de programação contexto estruturado sobre o projeto, que eles possam ler e citar.
• Validar automaticamente bundles de conhecimento no CI antes de fazer o merge.
• Reconstruir a documentação de um projeto em um repositório que ainda não tenha um bundle.

Início rápido

1. 1

   Adicione o marketplace ao Claude Code

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

   Instale o plugin okf

   /plugin install okf@scaccogatto
3. 3

   Documente um projeto no OKF pedindo ao Claude que gere um bundle

   /okf:okf produce .okf
4. 4

   Valide o bundle antes de fazer o commit

   /okf:validate .okf --strict

Antes de usar

• !A toolchain completa foi criada para o Claude Code; outros agentes têm acesso apenas às skills, sem subagentes de backfill.
• !Os scripts precisam do uv ou do python3 com o pyyaml instalado.
• !O projeto ainda está na versão pré-1.0, então a tag de ação @v1 pode mudar entre versões.

Em coleções

Tópicos

Perguntas frequentes

O que é okf-skills?

Toolkit do Claude Code para criar, validar, visualizar e manter bundles de conhecimento em Markdown no formato OKF (Open Knowledge Format). OKF é um formato aberto e independente de fornecedores para armazenar conhecimento sobre um sistema em um diretório de arquivos Markdown com YAML frontmatter. Este projeto permite que o Claude Code crie, mantenha, consulte, valide e visualize bundles OKF como parte do fluxo de trabalho normal. Ele inclui um verificador determinístico de conformidade com a especificação, um script de visualização que renderiza um bundle como um grafo interativo e uma skill de backfill que reconstrói um bundle a partir do histórico do Git e de transcrições de sessões.

okf-skills é gratuito? Qual é a licença?

okf-skills é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

okf-skills ainda é mantido?

Manutenção ativa. O último commit de okf-skills foi em 4 de nov. de 2026.

Para que posso usar okf-skills?

Documentar a arquitetura e as decisões de um serviço em arquivos Markdown versionados junto ao código. Fornecer aos agentes de programação contexto estruturado sobre o projeto, que eles possam ler e citar. Validar automaticamente bundles de conhecimento no CI antes de fazer o merge. Reconstruir a documentação de um projeto em um repositório que ainda não tenha um bundle.

Como instalar okf-skills?

Adicione o marketplace ao Claude Code: /plugin marketplace add scaccogatto/okf-skills Instale o plugin okf: /plugin install okf@scaccogatto Documente um projeto no OKF pedindo ao Claude que gere um bundle: /okf:okf produce .okf Valide o bundle antes de fazer o commit: /okf:validate .okf --strict

Onde consigo okf-skills?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/scaccogatto/okf-skills