Referência da API

Skills

Publique pacotes versionados de conhecimento e arquivos usados por agents.

#Endpoints

Método	Caminho	Descrição
POST	`/v1/skills`	Cria a skill com a primeira versão.
POST	`/v1/skills/:id`	Publica nova versão.
POST	`/v1/skills/:id/archive`	Arquiva a skill.
GET	`/v1/skills`	Lista skills por cursor e filtro de nome.
GET	`/v1/skills/:id/versions`	Lista versões.
GET	`/v1/skills/:id/files/*path`	Obtém arquivo da skill.
GET	`/v1/skills/:id`	Lê manifest e arquivos de uma versão.

#Publicar

json

{
  "manifest": {
    "name": "sinistros-auto",
    "description": "Procedimento para análise inicial de sinistros auto",
    "entry": "SKILL.md"
  },
  "files": [
    {
      "path": "SKILL.md",
      "content": "# Sinistros auto\n\nSiga o checklist antes de concluir."
    }
  ]
}

O manifesto pode ser derivado do SKILL.md quando você envia uma pasta compatível.

#Versões

Para publicar uma nova versão, envie o conteúdo atualizado e a versão atual esperada.

json

{
  "version": 1,
  "files": [{ "path": "SKILL.md", "content": "# Sinistros auto\n\nNovo procedimento." }]
}