Skill OKF — Instalar e Usar
Skill pra agentes de código (Claude, Codex, Cursor, Kiro, Windsurf) que ensina a criar, validar e enriquecer bundles OKF.
Instalar
Claude Code / Kiro CLI
# Adicionar ao projeto
npx skills add fabricioctelles/skills/okf-open-knowledge-formatOu na mão — clone e referencie:
git clone https://github.com/fabricioctelles/skills.git ~/.skillsDepois adicione no .claude/settings.json ou AGENTS.md:
{
"skills": ["~/.skills/skills/okf-open-knowledge-format/SKILL.md"]
}Cursor / Windsurf
Jogue nas rules do projeto:
Read and follow: https://raw.githubusercontent.com/fabricioctelles/skills/main/skills/okf-open-knowledge-format/SKILL.mdReferência direta (qualquer agente)
Aponte seu agente para a URL raw:
https://raw.githubusercontent.com/fabricioctelles/skills/main/skills/okf-open-knowledge-format/SKILL.mdO Que a Skill Faz
| Capacidade | O que rola |
|---|---|
| Criar | Gera bundles OKF conformantes do zero |
| Validar | Checa as 3 regras de conformidade, reporta erros e warnings |
| Enriquecer | Adiciona schema, citations, cross-links, preenche campos recomendados |
| Gerar | Cria index.md e log.md automaticamente |
| Converter | Transforma exports Notion, vaults Obsidian ou CSVs em OKF |
| Servir | Envia bundles pro Google Cloud Knowledge Catalog via kcmd CLI/MCP |
Exemplos de Uso
Criar um bundle
"Crie um bundle OKF documentando nossos endpoints de API: /users, /orders, /payments"O agente gera diretório completo com concept docs, cross-links e index.
Validar docs existentes
"Valide essa pasta contra a spec OKF"Checa as 3 regras e reporta pass/fail por arquivo.
Converter do Obsidian
"Converta meu vault Obsidian em ./knowledge/ para formato OKF"Converte wikilinks pra links padrão, garante type em todo frontmatter, gera index/log.
Recursos Incluídos
A skill carrega material de referência sob demanda:
| Arquivo | O que tem |
|---|---|
references/spec-v01.md | Spec OKF v0.1 completa (451 linhas) |
references/examples.md | 3 bundles de exemplo completos |
references/conversion.md | Guias de conversão (Notion, Obsidian, CSV) |
scripts/validate.sh | Script bash validador (zero dependências) |
O Script validate.sh
Dá pra rodar o validador direto também:
chmod +x scripts/validate.sh
./scripts/validate.sh ./meu-bundle/Saída:
✅ Bundle is OKF v0.1 conformant
⚠️ 2 warning(s)Integração com Knowledge Catalog
A skill também sabe enviar bundles OKF pro Google Cloud Knowledge Catalog — que ingere OKF nativamente desde junho de 2026.
Enviar bundle via kcmd
"Envie meu bundle OKF pro Knowledge Catalog"O agente guia no setup do kcmd init, kcmd push, e configuração do MCP server pra comunicação agente→catálogo.
Usar como recurso MCP
A skill entende as tools MCP do kcmd (pull, push, list-entries, lookup-entry, modify-entry) e ajuda a configurar pro Claude Desktop, Cursor, ou qualquer agente compatível com MCP.