Skill do Claude para calcular portagens
Resposta direta: uma skill do Claude é uma pasta com instruções (e opcionalmente scripts) que ensina o Claude a fazer uma tarefa com as ferramentas que já tem. Para portagens, a skill não adiciona acesso à rede: é preciso um canal real até à API — o servidor MCP documentado ou execução de scripts com rede. A skill fixa o conhecimento: que endpoint, que classe de veículo, como apresentar o detalhe e marcar resultados como estimativas.
Skill vs MCP
- Claude com ferramentas (Claude Code local ou Claude Desktop com integração MCP): a skill funciona como camada de procedimento por cima.
- Claude chat sem ferramentas: a skill não consegue chamar a API; monte primeiro o MCP.
Estrutura mínima
skills/tolls-calculator/SKILL.md com o fluxo (pedir origem/destino ou polyline; chamar POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate via a ferramenta disponível; apresentar resultados por segmento com data da consulta; nunca dar preço sem chamada real) e, opcionalmente, scripts/ com um helper curl. A API key vai em variáveis de ambiente — nunca no ficheiro da skill.
Este é um padrão de integração que constrói; não se afirma existir uma skill oficial publicada.