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

# Adicionar ao projeto
npx skills add fabricioctelles/skills/okf-open-knowledge-format

Ou na mão — clone e referencie:

git clone https://github.com/fabricioctelles/skills.git ~/.skills

Depois adicione no .claude/settings.json ou AGENTS.md:

{
  "skills": ["~/.skills/skills/okf-open-knowledge-format/SKILL.md"]
}

Jogue nas rules do projeto:

Read and follow: https://raw.githubusercontent.com/fabricioctelles/skills/main/skills/okf-open-knowledge-format/SKILL.md

Aponte seu agente para a URL raw:

https://raw.githubusercontent.com/fabricioctelles/skills/main/skills/okf-open-knowledge-format/SKILL.md

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

"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.

"Valide essa pasta contra a spec OKF"

Checa as 3 regras e reporta pass/fail por arquivo.

"Converta meu vault Obsidian em ./knowledge/ para formato OKF"

Converte wikilinks pra links padrão, garante type em todo frontmatter, gera index/log.

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)

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)