> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinglog.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Regras para o agente integrar com a KingLog sem inventar rota, campo ou permissão.

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.

> [card] Contexto preciso
>
> Método, caminho e `operationId` saem da referência, não de um palpite.

> [card] Padronização
>
> Empresa e usuário vêm da sessão. O cliente da tarefa é uuid, nunca o nome.

> [card] Aceleração
>
> O agente descreve a operação e chama, em vez de reler a API inteira.

> [card] Exemplos reais
>
> Criar tarefa, mover lead, abrir ticket e calcular uma métrica.

> [card] Feita para IA
>
> Regras curtas, com o nome da ferramenta ou da rota.

> [card] 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](https://docs.kinglog.com.br/pages/ai/mcp.md).

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

### Catálogo

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](https://docs.kinglog.com.br/pages/webhooks/index.md).

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

> [card] Também para gente
>
> As mesmas regras servem para quem está integrando na mão.

> [card] Uma fonte
>
> Referência, MCP e esta página descrevem o mesmo catálogo.

> [card] [Referência da API](https://docs.kinglog.com.br/pages/reference/introduction.md)
>
> O catálogo fechado que as skills mandam o agente consultar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.