Skip to main content
As KingLog Skills são as regras para integrar sem inventar caminho, campo ou permissão. Quem usa o assistente no Cursor ou no Claude já segue essas regras. Quem escreve a integração na própria aplicação usa esta página como o contrato.

​
O que são Skills?

Skills descrevem:
  • a sessão da pessoa na empresa
  • o catálogo fechado de operações
  • a ordem leitura, depois escrita
  • a consulta estruturada, sem SQL
  • o que a API recusa
Elas servem para Cursor, Claude Code e qualquer editor que leia regras do projeto.

Contexto preciso

Método, caminho e operationId saem da referência, não de um palpite.

Padronização

Empresa e usuário vêm da sessão. O cliente da tarefa é uuid, nunca o nome.

Aceleração

O agente descreve a operação e chama, em vez de reler a API inteira.

Exemplos reais

Criar tarefa, mover lead, abrir ticket e calcular uma métrica.

Feita para IA

Regras curtas, com o nome da ferramenta ou da rota.

Menos erros

Menos rota inventada, menos exclusão sem pedido e menos SQL.

​
Como usar

1

Ligue o assistente quando a ação é na conta

Com a chave kl_live_, o Cursor ou o Claude já aplica estas regras. A configuração está em MCP Server.
2

Use esta página quando a integração é no seu sistema

No Cursor, referencie esta página nas regras do projeto. No Claude, inclua o link na tarefa de integração.

​
Regras

​
Sessão

A chave ou o JWT identificam uma pessoa numa empresa. companyId e userId saem dessa sessão. A chave nunca amplia o que a conta pode fazer. Com grants, ela faz só o conjunto gravado. Para “minhas tarefas” ou “meus leads”, o filtro usa @me no campo de usuário. O servidor troca pelo id da sessão. Toda escrita passa por um operationId que existe, como tasks.create ou crm.leads.moveStage. Se o id não existe, descreva de novo e use uma sugestão. Não monte uma URL livre. Antes de gravar, confirme o id com kinglog_search, kinglog_read ou a rota de leitura correspondente.

​
Tarefa, lead e ticket

Criar tarefa exige title, boardStatusId, boardPriorityId, o uuid do cliente e as datas. date_sprint substitui date_start e date_end. Mover lead usa crm.leads.moveStage ou crm.leads.moveColumn, com o id que a API devolveu. Ticket nasce num quadro e num status do help desk. Comentário aceita content ou document_json. is_internal começa falso.

​
Consulta

Perguntas de lista, contagem e indicador usam POST /ai/query/describe, /run, /aggregate e /metrics. Não envie SQL. Em QUERY_INVALID, a mensagem lista os campos válidos: corrija e repita. A resposta de métrica inclui definition e caveats. Os dois acompanham o número.

​
Exclusão e fora de escopo

Efeito delete só segue com confirm=true, e só quando a pessoa pediu para apagar. Upload, webhook, admin, cobrança, OAuth externo e senha não entram pelo assistente. Essas ações ficam na API com a sessão normal, nas rotas da referência e dos webhooks.

​
Filosofia

  • Explícitas. Cada regra nomeia a rota ou a ferramenta.
  • Auditáveis. O texto desta página é a fonte. O servidor repete a mesma lista.
  • Modulares. Sessão, catálogo, consulta e exclusão se leem separados.
  • Presas à conta. O agente faz o que a pessoa já pode fazer.

Também para gente

As mesmas regras servem para quem está integrando na mão.

Uma fonte

Referência, MCP e esta página descrevem o mesmo catálogo.

Referência da API

O catálogo fechado que as skills mandam o agente consultar.