openapi/openapi-skills

Skills de agente para usar e integrar os serviços do marketplace de APIs Openapi — o maior marketplace de APIs certificado da Europa.

npx skills add openapi/openapi-skills

Estrutura do repositório

Pasta	Finalidade
knowledge/	Base de conhecimento curada: perfil da empresa, catálogo de serviços, guia da plataforma (autenticação, faturamento, sandbox), FAQ, referências, documentação de endpoints por serviço e especificações OpenAPI armazenadas
skills/	As skills do agente, uma pasta por domínio, cada uma com um SKILL.md

Separação entre conhecimento e skills

As duas pastas possuem papéis estritamente separados:

• knowledge/ é material de construção. É a massa de informações curadas usada para criar e alinhar as skills (e para atualizá-las quando a Openapi mudar). É consultada pelos mantenedores deste repositório, não por agentes executando uma skill.
• skills/ são entregáveis autocontidos. Cada SKILL.md é preenchido a partir do conhecimento, mas nunca vincula a ele: um agente deve ser capaz de usar uma skill sem que a pasta knowledge/ deste repositório esteja disponível.
• Referências externas são permitidas nas skills, mas nunca roteadas através de knowledge/. As skills apontam diretamente para fontes oficiais — por exemplo, as especificações canônicas em https://console.openapi.com/oas/en/<service>.openapi.json, o portal de documentação, a página de status — e não para cópias locais delas.

Fluxo de manutenção: atualize knowledge/ a partir das fontes oficiais primeiro, depois propague o conteúdo relevante para os arquivos SKILL.md afetados.

Skills

Skill	Abrange
openapi-auth	Ciclo de vida do token OAuth v2, escopos, carteira, estatísticas de uso (obrigatório para todas as outras)
openapi-company	Dados empresariais: Itália, UE, mundo
openapi-documents	Documentos oficiais: visuras camerais, balanços, DURC, protestos (DocuEngine, Visure Camerali, Visengine)
openapi-risk	Scores de crédito, relatórios CRIF, KYC, eventos negativos
openapi-trust	Validação de e-mails, telefones, IPs, URLs, PEC, códigos fiscais, placas
openapi-geo	Geocodificação, códigos postais, cadastro italiano, avaliações imobiliárias
openapi-messaging	SMS v2, PEC, Massive REM, correspondência postal via Poste Italiane
openapi-esignature	Assinaturas eletrônicas eIDAS e carimbo de tempo qualificado
openapi-invoicing	Faturamento eletrônico (Invoice, SDI) e pagamentos de contas
openapi-automotive	Dados veiculares por placa
openapi-utilities	Taxas de câmbio, HTML para PDF, domínios .it, RAG gerenciado

Credenciais

As skills esperam OPENAPI_EMAIL e OPENAPI_API_KEY (credenciais de conta para oauth.openapi.com) e/ou um token Bearer OPENAPI_TOKEN pronto no ambiente. Veja knowledge/platform-guide.md.

Contribuindo

Contribuições são sempre bem-vindas! Esteja você querendo relatar bugs, sugerir novas funcionalidades, melhorar a documentação ou contribuir com código, sua ajuda é apreciada.

Autores

• Francesco Bianco (@francescobianco)
• Equipe Openapi (@openapi-it)

Parceiros

Conheça nossos parceiros que utilizam a Openapi ou contribuem com este projeto:

• Blank
• Credit Safe
• Deliveroo
• Gruppo MOL
• Jakala
• Octotelematics
• OTOQI
• PWC
• QOMODO S.R.L.
• SOUNDREEF S.P.A.

Nossos Compromissos

Acreditamos em código aberto e agimos de acordo com essa crença. Tornamo-nos Membros Silver da Linux Foundation porque queríamos apoiar formalmente o ecossistema no qual construímos todos os dias. Padrões abertos, colaboração aberta e governança aberta fazem parte de como trabalhamos e como pensamos sobre software.

Licença

Este projeto está licenciado sob a Licença MIT.

A Licença MIT é uma licença de código aberto permissiva que permite que você use, copie, modifique, mescle, publique, distribua, sublicencie e/ou venda cópias do software, desde que o aviso de direitos autorais original e este aviso de permissão sejam incluídos em todas as cópias ou partes substanciais do software.

Para mais detalhes, veja o texto completo da licença na página da Licença MIT.