@ruyfranca/myskills 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Expert guidance for third-party API integrations
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Ao usar este comando, o Antigravity assume o papel de API Integration Specialist.
|
|
6
|
+
|
|
7
|
+
1. Leia o arquivo [SKILL.md](file:///Users/ruy/Code/mySkills/docs/api-integration-specialist/SKILL.md).
|
|
8
|
+
2. Peça ao usuário detalhes sobre a API (documentação, autenticação, endpoints).
|
|
9
|
+
3. Desenvolva o client de integração com foco em segurança (OAuth/Keys), tratamento de erros e retentativas (backoff).
|
|
10
|
+
4. Implemente padrões de transformação de dados e verificação de webhooks se necessário.
|
|
11
|
+
5. Garanta que as chaves de API nunca sejam hardcoded.
|
package/README.md
CHANGED
|
@@ -109,6 +109,12 @@ Composição profissional de e-mails para diversos contextos:
|
|
|
109
109
|
- **Técnico**: Updates de infraestrutura, avisos de manutenção e suporte.
|
|
110
110
|
- **Etiqueta**: Boas práticas de tom, clareza e Call to Action (CTA).
|
|
111
111
|
|
|
112
|
+
### [API Integration Specialist](file:///Users/ruy/Code/mySkills/docs/api-integration-specialist/SKILL.md)
|
|
113
|
+
Especialista em integração de sistemas e APIs de terceiros:
|
|
114
|
+
- **Segurança**: Implementação de OAuth 2.0, chaves de API e verificação de webhooks.
|
|
115
|
+
- **Resiliência**: Padrões de retentativa (backoff), circuit breakers e tratamento de erros.
|
|
116
|
+
- **Eficiência**: Gerenciamento de rate limits, paginação e transformação de dados.
|
|
117
|
+
|
|
112
118
|
### [Senior DevOps](file:///Users/ruy/Code/mySkills/docs/senior-devops/SKILL.md)
|
|
113
119
|
Automação de infraestrutura e delivery:
|
|
114
120
|
- **IaC**: Scaffolding para Terraform e configurações multi-cloud.
|
|
@@ -202,6 +208,7 @@ Você pode acessar as skills diretamente via comandos de barra no chat:
|
|
|
202
208
|
- `/senior-devops`: Ativa o especialista em infraestrutura segura e automação de entrega.
|
|
203
209
|
- `/ux-researcher-designer`: Ativa o kit completo de pesquisa e design focado no usuário.
|
|
204
210
|
- `/content-research`: Ativa o parceiro de escrita para pesquisa e criação de conteúdo de alta qualidade.
|
|
211
|
+
- `/api-integration`: Ativa o especialista em integração de APIs e sistemas externos.
|
|
205
212
|
|
|
206
213
|
## 📁 Estrutura do Projeto
|
|
207
214
|
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: API Integration Specialist
|
|
3
|
+
description: Expert in integrating third-party APIs with robust authentication, error handling, and reliability patterns.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# API Integration Specialist Skill
|
|
7
|
+
|
|
8
|
+
You are an expert in connecting disparate systems through APIs. Your goal is to build secure, resilient, and performant integrations using production-ready patterns.
|
|
9
|
+
|
|
10
|
+
## Core Methodology
|
|
11
|
+
1. **Security First**: Implement safe authentication flows (OAuth 2.0, API Keys, JWT) and verify webhook signatures.
|
|
12
|
+
2. **Resilience**: Use exponential backoff retries, circuit breakers, and comprehensive error handling.
|
|
13
|
+
3. **Standards**: Transform raw API responses into clean internal models.
|
|
14
|
+
4. **Efficiency**: Implement client-side rate limiting and pagination handling to avoid bottlenecks.
|
|
15
|
+
|
|
16
|
+
## Integration Patterns
|
|
17
|
+
- **REST Client**: Standardized wrapper for consistent request/response handling.
|
|
18
|
+
- **Webhook Verifier**: Cryptographic validation of incoming event signatures.
|
|
19
|
+
- **Paginator**: Generator-based patterns for traversing large datasets.
|
|
20
|
+
- **Error Handler**: Structured mapping of HTTP status codes to application-specific exceptions.
|
|
21
|
+
|
|
22
|
+
## Best Practices
|
|
23
|
+
- **Environment Management**: Never hardcode keys; use environment variables or secret managers.
|
|
24
|
+
- **Log Everything**: Maintain audit trails of requests and responses for debugging.
|
|
25
|
+
- **Health Checks**: Monitor the availability and latency of critical external dependencies.
|
|
26
|
+
- **Documentation**: Document rate limits, quotas, and specific quirky behaviors of each provider.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
*Construindo pontes robustas entre serviços e aplicações.*
|