Utilizando um assistente de IA

Antes de utilizar a skill de integração, leia o Guia de integração. A Skill é um atalho e não substitui a leitura do guia.

Fazendo o download da Skill

Faça o download do arquivo SKILL.md e use-o junto com o Guia de Integração.

O arquivo descreve o mesmo contrato desta página como instrução normativa para assistentes de IA, como o Claude. Com o arquivo carregado, o assistente gera ou revisa código de integração aplicando as regras desta página, sem que você precise copiar as regras em cada pedido.

Carregando o arquivo

A tabela a seguir mostra como carregar o arquivo em cada ferramenta.

Ferramenta	Como carregar
Claude Code (terminal, no seu próprio projeto)	Copie a pasta recebida para `.claude/skills/integracao-clientconecta/SKILL.md` dentro do repositório da aplicação. O Claude Code reconhece a skill automaticamente pelo nome e pela descrição, sem configuração adicional.
Claude.ai ou Claude Desktop (web ou aplicativo)	Anexe o arquivo `SKILL.md` à conversa antes de pedir código. Em um Project, adicione-o ao conhecimento do Project uma única vez.
Qualquer outro assistente de IA	Cole o conteúdo do arquivo como contexto ou instrução antes do pedido. É Markdown puro, sem dependência do Claude.

Exemplos de comando

Depois de carregar o arquivo, envie ao assistente comandos como os exemplificados a seguir:

Gerando uma integração nova

Anexei o arquivo integracao-clientconecta/SKILL.md. Preciso integrar com a biblioteca
Client Conecta em uma aplicação C# (.NET) para Windows, WinForms, carregando a
clientconecta.dll da pasta do executável. Siga exatamente as regras desse arquivo e
me pergunte o que faltar antes de gerar código.

Pedindo uma combinação de plataforma e linguagem

Usando o arquivo integracao-clientconecta/SKILL.md anexo, gere o esqueleto de uma
integração em Python (ctypes) para Linux, aplicação console, incluindo o
encerramento correto (_exit, sem dlclose) e o tratamento do callback.

Revisando uma integração

Com base no arquivo integracao-clientconecta/SKILL.md anexo, revise o código abaixo:
ele mascara o ClientSecret no log, trata PPOper sempre com 2 dígitos e acumula todas
as páginas da consulta (Oper 008)? Aponte qualquer divergência com o contrato.

[cole aqui o código da sua integração]

No Claude Code, com a pasta copiada para .claude/skills/integracao-clientconecta/

Use a skill integracao-clientconecta para revisar a Oper 005 da minha integração.

Antes de gerar código, o arquivo instrui o assistente a perguntar o que ainda não foi informado. Ele não deve assumir a plataforma só pela palavra "DLL" no nome do produto. Tenha à mão o sistema operacional e a arquitetura, a linguagem, o tipo de aplicação (gráfica ou console) e o caminho de onde a biblioteca será carregada.