Okf skill

O que ela faz

O OKF (Open Knowledge Format) guarda o conhecimento de um projeto numa pasta de arquivos Markdown com cabeçalho YAML: um assunto por arquivo, como um serviço, uma API, uma métrica, um procedimento ou uma decisão. A skill segue a especificação 0.2, que vem junto, e cria a pasta .okf na raiz do repositório.

Ela tem três modos. Produzir: monta o pacote a partir do código, da documentação ou do que você conta. Manter: quando o código muda, atualiza os arquivos afetados, marca o que saiu como obsoleto e anota no log. Consumir: lê o índice primeiro e só abre o que a tarefa pede.

Cada arquivo pode dizer quem escreveu e quando, quem conferiu, se é rascunho, quando vence e de onde veio cada informação. Antes de terminar, o Claude roda um validador que aponta erros e avisos, em vez de conferir no olho.

Nas palavras de quem fez

Quando usar

• Documentar os serviços e as APIs de um projeto pro próximo agente entender
• Registrar decisões e procedimentos do time num lugar só
• Atualizar a documentação depois de mudar o código
• Dar contexto confiável ao Claude num repositório que já tem pasta .okf

Depois de instalar, é só pedir assim

• Cria um pacote OKF desse repositório com um arquivo pra cada serviço e cada endpoint da API
• Mudei o fluxo de pagamento: atualiza o pacote OKF e valida
• Registra no OKF a decisão de trocar o banco pra Postgres, com a data e quem decidiu

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykPassou

Perguntas