opencode-skills-collection 3.0.3 → 3.0.4

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.
Files changed (88) hide show
  1. package/README.md +1 -2
  2. package/bundled-skills/.antigravity-install-manifest.json +3 -1
  3. package/bundled-skills/20-andruia-niche-intelligence/SKILL.md +1 -1
  4. package/bundled-skills/advogado-criminal/SKILL.md +49 -49
  5. package/bundled-skills/advogado-especialista/SKILL.md +49 -49
  6. package/bundled-skills/agent-memory-systems/SKILL.md +1 -1
  7. package/bundled-skills/agents-v2-py/SKILL.md +1 -1
  8. package/bundled-skills/ai-product/SKILL.md +7 -7
  9. package/bundled-skills/amazon-alexa/SKILL.md +14 -14
  10. package/bundled-skills/andrej-karpathy/SKILL.md +12 -12
  11. package/bundled-skills/angular-best-practices/SKILL.md +0 -4
  12. package/bundled-skills/apify-actorization/SKILL.md +2 -2
  13. package/bundled-skills/audit-context-building/SKILL.md +8 -8
  14. package/bundled-skills/auri-core/SKILL.md +9 -9
  15. package/bundled-skills/autonomous-agents/SKILL.md +1 -1
  16. package/bundled-skills/azure-search-documents-py/SKILL.md +5 -5
  17. package/bundled-skills/backend-dev-guidelines/SKILL.md +13 -13
  18. package/bundled-skills/bill-gates/SKILL.md +2 -2
  19. package/bundled-skills/browser-automation/SKILL.md +14 -14
  20. package/bundled-skills/carrier-relationship-management/SKILL.md +1 -1
  21. package/bundled-skills/cc-skill-security-review/SKILL.md +1 -1
  22. package/bundled-skills/cred-omega/SKILL.md +21 -21
  23. package/bundled-skills/customs-trade-compliance/SKILL.md +1 -1
  24. package/bundled-skills/docker-expert/SKILL.md +1 -1
  25. package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
  26. package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
  27. package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
  28. package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
  29. package/bundled-skills/docs/users/bundles.md +1 -1
  30. package/bundled-skills/docs/users/claude-code-skills.md +1 -1
  31. package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
  32. package/bundled-skills/docs/users/getting-started.md +1 -1
  33. package/bundled-skills/docs/users/kiro-integration.md +1 -1
  34. package/bundled-skills/docs/users/usage.md +4 -4
  35. package/bundled-skills/docs/users/visual-guide.md +4 -4
  36. package/bundled-skills/elon-musk/SKILL.md +50 -50
  37. package/bundled-skills/email-systems/SKILL.md +18 -18
  38. package/bundled-skills/energy-procurement/SKILL.md +1 -1
  39. package/bundled-skills/evaluation/SKILL.md +1 -1
  40. package/bundled-skills/frontend-dev-guidelines/SKILL.md +16 -16
  41. package/bundled-skills/git-pr-review/SKILL.md +167 -0
  42. package/bundled-skills/hosted-agents/SKILL.md +1 -1
  43. package/bundled-skills/hosted-agents-v2-py/SKILL.md +1 -1
  44. package/bundled-skills/ilya-sutskever/SKILL.md +18 -18
  45. package/bundled-skills/image-studio/SKILL.md +6 -6
  46. package/bundled-skills/inventory-demand-planning/SKILL.md +1 -1
  47. package/bundled-skills/leiloeiro-edital/SKILL.md +4 -4
  48. package/bundled-skills/leiloeiro-juridico/SKILL.md +8 -8
  49. package/bundled-skills/leiloeiro-risco/SKILL.md +2 -2
  50. package/bundled-skills/linear-claude-skill/SKILL.md +0 -24
  51. package/bundled-skills/linkedin-cli/SKILL.md +1 -1
  52. package/bundled-skills/logistics-exception-management/SKILL.md +1 -1
  53. package/bundled-skills/matematico-tao/SKILL.md +6 -6
  54. package/bundled-skills/mental-health-analyzer/SKILL.md +1 -1
  55. package/bundled-skills/multi-advisor/SKILL.md +8 -8
  56. package/bundled-skills/nestjs-expert/SKILL.md +1 -1
  57. package/bundled-skills/nodejs-best-practices/SKILL.md +2 -2
  58. package/bundled-skills/postgres-best-practices/SKILL.md +1 -1
  59. package/bundled-skills/prisma-expert/SKILL.md +1 -1
  60. package/bundled-skills/product-inventor/SKILL.md +5 -5
  61. package/bundled-skills/production-scheduling/SKILL.md +1 -1
  62. package/bundled-skills/quality-nonconformance/SKILL.md +1 -1
  63. package/bundled-skills/react-best-practices/SKILL.md +1 -1
  64. package/bundled-skills/react-patterns/SKILL.md +8 -0
  65. package/bundled-skills/rehabilitation-analyzer/SKILL.md +1 -1
  66. package/bundled-skills/returns-reverse-logistics/SKILL.md +1 -1
  67. package/bundled-skills/skill-audit/SKILL.md +174 -0
  68. package/bundled-skills/skill-rails-upgrade/SKILL.md +2 -2
  69. package/bundled-skills/social-orchestrator/SKILL.md +4 -4
  70. package/bundled-skills/steve-jobs/SKILL.md +24 -24
  71. package/bundled-skills/telegram/SKILL.md +1 -1
  72. package/bundled-skills/typescript-expert/SKILL.md +1 -1
  73. package/bundled-skills/ui-ux-pro-max/SKILL.md +1 -1
  74. package/bundled-skills/verification-before-completion/SKILL.md +1 -1
  75. package/bundled-skills/voice-agents/SKILL.md +27 -27
  76. package/bundled-skills/warren-buffett/SKILL.md +2 -2
  77. package/bundled-skills/whatsapp-cloud-api/SKILL.md +1 -1
  78. package/bundled-skills/wiki-architect/SKILL.md +1 -1
  79. package/bundled-skills/wiki-changelog/SKILL.md +1 -1
  80. package/bundled-skills/wiki-onboarding/SKILL.md +1 -1
  81. package/bundled-skills/wiki-page-writer/SKILL.md +1 -1
  82. package/bundled-skills/wiki-qa/SKILL.md +1 -1
  83. package/bundled-skills/wiki-researcher/SKILL.md +1 -1
  84. package/bundled-skills/wiki-vitepress/SKILL.md +1 -1
  85. package/bundled-skills/workflow-automation/SKILL.md +10 -10
  86. package/bundled-skills/zapier-make-patterns/SKILL.md +10 -10
  87. package/package.json +1 -1
  88. package/skills_index.json +44 -0
@@ -108,7 +108,7 @@ A combinação que Karpathy representa é genuinamente rara:
108
108
 
109
109
  ---
110
110
 
111
- ## 2.1 — Software 2.0
111
+ ### 2.1 — Software 2.0
112
112
 
113
113
  Publicado no Medium em 2017, este é o ensaio mais original e influente de Karpathy.
114
114
  A tese central mudou como a comunidade pensa sobre o que é programação:
@@ -147,7 +147,7 @@ the training data and curate the dataset. We are reprogramming computers with da
147
147
  **Com LLMs (2023):** Dataset = internet inteira. Loss = cross-entropy no próximo token.
148
148
  Emergência de capacidades que ninguém especificou explicitamente. Software 2.0 em escala máxima.
149
149
 
150
- ## 2.2 — Llms Como Sistema Operacional
150
+ ### 2.2 — Llms Como Sistema Operacional
151
151
 
152
152
  Esta analogia, desenvolvida em 2023 (especialmente na palestra "State of GPT" no
153
153
  Microsoft Build), reframeu como pensar em LLMs como plataforma:
@@ -182,7 +182,7 @@ entendem linguagem natural e podem executar tarefas complexas quando instruídos
182
182
  em inglês, então inglês se tornou literalmente uma linguagem de programação —
183
183
  uma que qualquer falante nativo já "sabe", sem precisar aprender sintaxe especial.
184
184
 
185
- ## 2.3 — Bottom-Up Learning (Filosofia Pedagógica Central)
185
+ ### 2.3 — Bottom-Up Learning (Filosofia Pedagógica Central)
186
186
 
187
187
  A regra mais importante: construa do zero antes de usar a biblioteca. Entenda a
188
188
  abstração antes de depender dela.
@@ -205,7 +205,7 @@ o estudante entende cada componente de qualquer LLM moderno.
205
205
  **Citação:** "The library is just convenience; the math is the substance. Once you
206
206
  understand how backprop works, you can use PyTorch with full confidence."
207
207
 
208
- ## 2.4 — Vibe Coding
208
+ ### 2.4 — Vibe Coding
209
209
 
210
210
  Termo cunhado por Karpathy em fevereiro de 2025 em um tweet que viralizou na
211
211
  comunidade de programação. Define uma nova modalidade de desenvolvimento de
@@ -243,7 +243,7 @@ pequenos e exploratórios: superpotência. Para engenharia séria: ainda precisa
243
243
  pessoas que entendem o código. Mesmo "vibers" se beneficiam de fundamentos sólidos —
244
244
  para reconhecer quando o LLM gerou algo incorreto.
245
245
 
246
- ## 2.5 — Scaling Laws E Emergência
246
+ ### 2.5 — Scaling Laws E Emergência
247
247
 
248
248
  **O que são scaling laws:** Relações empíricas mostrando que performance melhora
249
249
  previsível e regularmente com mais parâmetros (N), mais dados (D), mais compute (C).
@@ -264,7 +264,7 @@ teoricamente melhor que não escala em hardware disponível.
264
264
 
265
265
  ---
266
266
 
267
- ## 3.1 — Contexto E Missão
267
+ ### 3.1 — Contexto E Missão
268
268
 
269
269
  Karpathy entrou na Tesla em junho de 2017 como Director of AI, assumindo
270
270
  responsabilidade pela equipe de visão e machine learning do Autopilot.
@@ -276,7 +276,7 @@ faixa para uma arquitetura de visão end-to-end capaz de condução autônoma em
276
276
  condições gerais. A stack construída foi a mais complexa e sofisticada de visão
277
277
  computacional já deployada em escala de produção massiva.
278
278
 
279
- ## 3.2 — A Decisão Cameras-Only (Vs Lidar)
279
+ ### 3.2 — A Decisão Cameras-Only (Vs Lidar)
280
280
 
281
281
  Este é talvez o debate técnico mais importante da carreira de Karpathy, e ele
282
282
  articulou o argumento com precisão cirúrgica:
@@ -314,7 +314,7 @@ articulou o argumento com precisão cirúrgica:
314
314
  - A abordagem cameras-only coloca peso enorme na rede neural — funciona se e
315
315
  somente se a rede for suficientemente boa, o que é uma aposta high-stakes.
316
316
 
317
- ## 3.3 — Hydranet: Uma Rede Para Tudo
317
+ ### 3.3 — Hydranet: Uma Rede Para Tudo
318
318
 
319
319
  Apresentado no Tesla AI Day (agosto 2021), o HydraNet é a arquitetura central
320
320
  de visão da Tesla descrita por Karpathy:
@@ -351,7 +351,7 @@ Backbone ──────────┼─── Head: Velocity Estimation (v
351
351
  um espaço de features compartilhado — o modelo "vê" o mundo 360° como um único
352
352
  volume de features, não como imagens separadas.
353
353
 
354
- ## 3.4 — A Data Engine: O Produto Real
354
+ ### 3.4 — A Data Engine: O Produto Real
355
355
 
356
356
  O conceito mais sofisticado que Karpathy desenvolveu e articulou na Tesla.
357
357
  Sua tese: o modelo de produção não é o produto. A data engine — o sistema de
@@ -392,7 +392,7 @@ loop fechado entre frota, anotação e treinamento — é o produto.
392
392
 
393
393
  **Citação:** "The data engi
394
394
 
395
- ## 3.5 — Dojo: Supercomputador Para Visão
395
+ ### 3.5 — Dojo: Supercomputador Para Visão
396
396
 
397
397
  Anunciado no Tesla AI Day 2021, Dojo foi o supercomputador proprietário da Tesla
398
398
  para treinamento de modelos de visão. Karpathy foi central na visão técnica:
@@ -403,7 +403,7 @@ para treinamento de modelos de visão. Karpathy foi central na visão técnica:
403
403
  - A decisão de construir hardware próprio reflete a filosofia de controle da stack
404
404
  que tanto Karpathy quanto Musk defendem
405
405
 
406
- ## 3.6 — O Que Karpathy Aprendeu Na Tesla
406
+ ### 3.6 — O Que Karpathy Aprendeu Na Tesla
407
407
 
408
408
  Em entrevistas e tweets após sair, Karpathy articulou as lições mais importantes:
409
409
 
@@ -424,7 +424,7 @@ Em entrevistas e tweets após sair, Karpathy articulou as lições mais importan
424
424
 
425
425
  ---
426
426
 
427
- ## 4.1 — Micrograd
427
+ ### 4.1 — Micrograd
428
428
 
429
429
  **Repositório:** github.com/karpathy/micrograd
430
430
  **Tamanho:** ~100 linhas de Python puro
@@ -557,10 +557,6 @@ export class Component implements OnInit, OnDestroy {
557
557
  - [Zoneless Angular](https://angular.dev/guide/experimental/zoneless)
558
558
  - [Angular SSR Guide](https://angular.dev/guide/ssr)
559
559
  - [Change Detection Deep Dive](https://angular.dev/guide/change-detection)
560
-
561
- ## When to Use
562
- This skill is applicable to execute the workflow or actions described in the overview.
563
-
564
560
  ## Limitations
565
561
  - Use this skill only when the task clearly matches the scope described above.
566
562
  - Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
@@ -115,7 +115,7 @@ See [schemas-and-output.md](references/schemas-and-output.md) for detailed confi
115
115
 
116
116
  Validate schemas against `@apify/json_schemas` npm package.
117
117
 
118
- ## Step 7: Test Locally
118
+ ## Step 4: Test Locally
119
119
 
120
120
  Run the actor with inline input (for JS/TS and Python actors):
121
121
 
@@ -131,7 +131,7 @@ apify run --input-file ./test-input.json
131
131
 
132
132
  **Important:** Always use `apify run`, not `npm start` or `python main.py`. The CLI sets up the proper environment and storage.
133
133
 
134
- ## Step 8: Deploy
134
+ ## Step 5: Deploy
135
135
 
136
136
  ```bash
137
137
  apify push
@@ -37,7 +37,7 @@ Do **not** use for:
37
37
 
38
38
  ---
39
39
 
40
- ## 3. How This Skill Behaves
40
+ ## 2. How This Skill Behaves
41
41
 
42
42
  When active, Claude will:
43
43
  - Default to **ultra-granular analysis** of each block and line.
@@ -64,7 +64,7 @@ Goal: **deep, accurate understanding**, not conclusions.
64
64
 
65
65
  ---
66
66
 
67
- ## 4. Phase 1 — Initial Orientation (Bottom-Up Scan)
67
+ ## 3. Phase 1 — Initial Orientation (Bottom-Up Scan)
68
68
 
69
69
  Before deep analysis, Claude performs a minimal mapping:
70
70
 
@@ -78,7 +78,7 @@ This establishes anchors for detailed analysis.
78
78
 
79
79
  ---
80
80
 
81
- ## 5. Phase 2 — Ultra-Granular Function Analysis (Default Mode)
81
+ ## 4. Phase 2 — Ultra-Granular Function Analysis (Default Mode)
82
82
 
83
83
  Every non-trivial function receives full micro analysis.
84
84
 
@@ -199,7 +199,7 @@ Analysis is complete when all checklist items are satisfied and no unresolved "u
199
199
 
200
200
  ---
201
201
 
202
- ## 6. Phase 3 — Global System Understanding
202
+ ## 5. Phase 3 — Global System Understanding
203
203
 
204
204
  After sufficient micro-analysis:
205
205
 
@@ -227,7 +227,7 @@ These clusters help guide the vulnerability-hunting phase.
227
227
 
228
228
  ---
229
229
 
230
- ## 7. Stability & Consistency Rules
230
+ ## 6. Stability & Consistency Rules
231
231
  *(Anti-Hallucination, Anti-Contradiction)*
232
232
 
233
233
  Claude must:
@@ -255,7 +255,7 @@ Claude must:
255
255
 
256
256
  ---
257
257
 
258
- ## 8. Subagent Usage
258
+ ## 7. Subagent Usage
259
259
 
260
260
  Claude may spawn subagents for:
261
261
  - Dense or complex functions.
@@ -275,7 +275,7 @@ Subagents must:
275
275
 
276
276
  ---
277
277
 
278
- ## 9. Relationship to Other Phases
278
+ ## 8. Relationship to Other Phases
279
279
 
280
280
  This skill runs **before**:
281
281
  - Vulnerability discovery
@@ -291,7 +291,7 @@ It exists solely to build:
291
291
 
292
292
  ---
293
293
 
294
- ## 10. Non-Goals
294
+ ## 9. Non-Goals
295
295
 
296
296
  While active, Claude should NOT:
297
297
  - Identify vulnerabilities
@@ -123,11 +123,11 @@ Exemplo de marcacao SSML para Amazon Polly Vitoria Neural:
123
123
  Fluxo de dados: Echo -> ASK SDK (Python v2) -> Lambda Python 3.12 -> Claude claude-opus-4-20250805
124
124
  Componentes AWS: DynamoDB (memoria), Polly Vitoria Neural (voz), CloudWatch (logs), Secrets Manager (keys)
125
125
 
126
- ## 3.1 Dependencias
126
+ ### 3.1 Dependencias
127
127
 
128
128
  ask-sdk-core==1.19.0 | ask-sdk-model==1.85.0 | boto3==1.34.0 | anthropic==0.25.0 | python-dotenv==1.0.0
129
129
 
130
- ## 3.2 Lambda Handler Principal
130
+ ### 3.2 Lambda Handler Principal
131
131
 
132
132
  Codigo Python - lambda_function.py:
133
133
  sb = CustomSkillBuilder()
@@ -136,7 +136,7 @@ Codigo Python - lambda_function.py:
136
136
  sb.add_global_response_interceptor(MemorySaveInterceptor())
137
137
  lambda_handler = sb.lambda_handler()
138
138
 
139
- ## 3.3 Handler De Conversa Com Claude
139
+ ### 3.3 Handler De Conversa Com Claude
140
140
 
141
141
  Codigo Python - handlers/conversation.py:
142
142
  class ConversationIntentHandler(AbstractRequestHandler):
@@ -147,20 +147,20 @@ Codigo Python - handlers/conversation.py:
147
147
  system=system_prompt, messages=history+[user_speech])
148
148
  Salva resposta no historico, retorna SSML com voz Vitoria
149
149
 
150
- ## 3.4 Dynamodb Schema
150
+ ### 3.4 Dynamodb Schema
151
151
 
152
152
  Tabela: auri-user-memory | PK: user_id | SK: session_date | TTL: 90 dias
153
153
  Campos: profile (name, plan, preferences), long_term_memory[], usage_stats{}
154
154
  BillingMode: PAY_PER_REQUEST | TimeToLive: habilitado (auto-expira)
155
155
 
156
- ## 3.5 Interaction Model
156
+ ### 3.5 Interaction Model
157
157
 
158
158
  invocationName: auri
159
159
  ConversationIntent: slot query (AMAZON.SearchQuery)
160
160
  Samples: {query}, me fala sobre {query}, o que e {query}, explica {query}
161
161
  StopIntent: tchau, ate mais, encerrar
162
162
 
163
- ## 3.6 Configuracao Lambda
163
+ ### 3.6 Configuracao Lambda
164
164
 
165
165
  FunctionName: auri-core-handler | Runtime: python3.12 | Timeout: 15s | Memory: 512MB
166
166
  Env vars: ANTHROPIC_API_KEY_SECRET, DYNAMODB_TABLE=auri-user-memory, POLLY_VOICE=Vitoria
@@ -168,7 +168,7 @@ Env vars: ANTHROPIC_API_KEY_SECRET, DYNAMODB_TABLE=auri-user-memory, POLLY_VOICE
168
168
 
169
169
  ---
170
170
 
171
- ## 3.7 Exemplos De Codigo Completos
171
+ ### 3.7 Exemplos De Codigo Completos
172
172
 
173
173
  Handler de Conversa (handlers/conversation.py):
174
174
 
@@ -542,7 +542,7 @@ Se a API da Anthropic estiver indisponivel, o sistema retorna respostas pre-conf
542
542
 
543
543
  ---
544
544
 
545
- ## 13. Glossario
545
+ ## 11. Glossario
546
546
 
547
547
  | Termo | Definicao |
548
548
  |-------|-----------|
@@ -566,7 +566,7 @@ Se a API da Anthropic estiver indisponivel, o sistema retorna respostas pre-conf
566
566
 
567
567
  ---
568
568
 
569
- ## 14. Links E Recursos
569
+ ## 12. Links E Recursos
570
570
 
571
571
  | Recurso | URL / Localizacao |
572
572
  |---------|-------------------|
@@ -814,7 +814,7 @@ Broad permissions + autonomy + goal optimization = danger.
814
814
 
815
815
  Recommended fix:
816
816
 
817
- ## Least privilege principle
817
+ ### Least privilege principle
818
818
  PERMISSIONS = {
819
819
  "research_agent": ["read_web", "read_docs"],
820
820
  "code_agent": ["read_file", "write_file", "run_tests"],
@@ -318,17 +318,17 @@ indexer_client.create_or_update_indexer(indexer)
318
318
 
319
319
  ## Additional Azure AI Search Patterns
320
320
 
321
- # Azure AI Search Python SDK
321
+ ### Additional SDK Focus
322
322
 
323
323
  Write clean, idiomatic Python code for Azure AI Search using `azure-search-documents`.
324
324
 
325
- ## Installation
325
+ ## Installation for Additional Patterns
326
326
 
327
327
  ```bash
328
328
  pip install azure-search-documents azure-identity
329
329
  ```
330
330
 
331
- ## Environment Variables
331
+ ## Environment Variables for Additional Patterns
332
332
 
333
333
  ```bash
334
334
  AZURE_SEARCH_ENDPOINT=https://<search-service>.search.windows.net
@@ -337,7 +337,7 @@ AZURE_SEARCH_INDEX_NAME=<index-name>
337
337
  AZURE_SEARCH_API_KEY=<api-key>
338
338
  ```
339
339
 
340
- ## Authentication
340
+ ## Authentication for Additional Patterns
341
341
 
342
342
  **DefaultAzureCredential (preferred)**:
343
343
  ```python
@@ -488,7 +488,7 @@ async with SearchClient(endpoint, index_name, credential) as client:
488
488
  print(result["title"])
489
489
  ```
490
490
 
491
- ## Best Practices
491
+ ## Best Practices for Additional Patterns
492
492
 
493
493
  1. **Use environment variables** for endpoints, keys, and deployment names
494
494
  2. **Prefer `DefaultAzureCredential`** over API keys for production
@@ -70,7 +70,7 @@ Automatically applies when working on:
70
70
 
71
71
  ---
72
72
 
73
- ## 3. Core Architecture Doctrine (Non-Negotiable)
73
+ ## 2. Core Architecture Doctrine (Non-Negotiable)
74
74
 
75
75
  ### 1. Layered Architecture Is Mandatory
76
76
 
@@ -186,7 +186,7 @@ No validation = bug.
186
186
 
187
187
  ---
188
188
 
189
- ## 4. Directory Structure (Canonical)
189
+ ## 3. Directory Structure (Canonical)
190
190
 
191
191
  ```
192
192
  src/
@@ -207,7 +207,7 @@ src/
207
207
 
208
208
  ---
209
209
 
210
- ## 5. Naming Conventions (Strict)
210
+ ## 4. Naming Conventions (Strict)
211
211
 
212
212
  | Layer | Convention |
213
213
  | ---------- | ------------------------- |
@@ -219,7 +219,7 @@ src/
219
219
 
220
220
  ---
221
221
 
222
- ## 6. Dependency Injection Rules
222
+ ## 5. Dependency Injection Rules
223
223
 
224
224
  * Services receive dependencies via constructor
225
225
  * No importing repositories directly inside controllers
@@ -235,7 +235,7 @@ export class UserService {
235
235
 
236
236
  ---
237
237
 
238
- ## 7. Prisma & Repository Rules
238
+ ## 6. Prisma & Repository Rules
239
239
 
240
240
  * Prisma client **never used directly in controllers**
241
241
  * Repositories:
@@ -250,7 +250,7 @@ await userRepository.findActiveUsers();
250
250
 
251
251
  ---
252
252
 
253
- ## 8. Async & Error Handling
253
+ ## 7. Async & Error Handling
254
254
 
255
255
  ### asyncErrorWrapper Required
256
256
 
@@ -269,7 +269,7 @@ No unhandled promise rejections.
269
269
 
270
270
  ---
271
271
 
272
- ## 9. Observability & Monitoring
272
+ ## 8. Observability & Monitoring
273
273
 
274
274
  ### Required
275
275
 
@@ -281,7 +281,7 @@ Every critical path must be observable.
281
281
 
282
282
  ---
283
283
 
284
- ## 10. Testing Discipline
284
+ ## 9. Testing Discipline
285
285
 
286
286
  ### Required Tests
287
287
 
@@ -301,7 +301,7 @@ No tests → no merge.
301
301
 
302
302
  ---
303
303
 
304
- ## 11. Anti-Patterns (Immediate Rejection)
304
+ ## 10. Anti-Patterns (Immediate Rejection)
305
305
 
306
306
  ❌ Business logic in routes
307
307
  ❌ Skipping service layer
@@ -313,7 +313,7 @@ No tests → no merge.
313
313
 
314
314
  ---
315
315
 
316
- ## 12. Integration With Other Skills
316
+ ## 11. Integration With Other Skills
317
317
 
318
318
  * **frontend-dev-guidelines** → API contract alignment
319
319
  * **error-tracking** → Sentry standards
@@ -323,7 +323,7 @@ No tests → no merge.
323
323
 
324
324
  ---
325
325
 
326
- ## 13. Operator Validation Checklist
326
+ ## 12. Operator Validation Checklist
327
327
 
328
328
  Before finalizing backend work:
329
329
 
@@ -337,13 +337,13 @@ Before finalizing backend work:
337
337
 
338
338
  ---
339
339
 
340
- ## 14. Skill Status
340
+ ## 13. Skill Status
341
341
 
342
342
  **Status:** Stable · Enforceable · Production-grade
343
343
  **Intended Use:** Long-lived Node.js microservices with real traffic and real risk
344
344
  ---
345
345
 
346
- ## When to Use
346
+ ### When to Use
347
347
  This skill is applicable to execute the workflow or actions described in the overview.
348
348
 
349
349
  ## Limitations
@@ -47,7 +47,7 @@ Agente que simula Bill Gates — cofundador da Microsoft, arquiteto da industria
47
47
 
48
48
  ---
49
49
 
50
- ## 1.1 Quem E Bill Gates — A Pessoa Real
50
+ ### 1.1 Quem E Bill Gates — A Pessoa Real
51
51
 
52
52
  William Henry Gates III nasceu em 28 de outubro de 1955 em Seattle, Washington.
53
53
  Filho de William H. Gates Sr. (advogado proeminente e filantropo) e Mary Maxwell Gates
@@ -75,7 +75,7 @@ achavam que o dinheiro estava no hardware.
75
75
  "The question is not whether we can solve the problem. It's whether we can measure
76
76
  whether we're solving it."
77
77
 
78
- ## 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
78
+ ### 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
79
79
 
80
80
  ```
81
81
  GATES 1975-1986 | FUNDADOR AGRESSIVO
@@ -698,7 +698,7 @@ Recommended fix:
698
698
 
699
699
  # Use stealth plugins:
700
700
 
701
- ## Puppeteer Stealth (best option):
701
+ ### Puppeteer Stealth (best option):
702
702
  import puppeteer from 'puppeteer-extra';
703
703
  import StealthPlugin from 'puppeteer-extra-plugin-stealth';
704
704
 
@@ -709,13 +709,13 @@ const browser = await puppeteer.launch({
709
709
  args: ['--disable-blink-features=AutomationControlled'],
710
710
  });
711
711
 
712
- ## Playwright Stealth:
712
+ ### Playwright Stealth:
713
713
  import { chromium } from 'playwright-extra';
714
714
  import stealth from 'puppeteer-extra-plugin-stealth';
715
715
 
716
716
  chromium.use(stealth());
717
717
 
718
- ## Manual (partial):
718
+ ### Manual (partial):
719
719
  await page.evaluateOnNewDocument(() => {
720
720
  Object.defineProperty(navigator, 'webdriver', {
721
721
  get: () => undefined,
@@ -745,7 +745,7 @@ Recommended fix:
745
745
 
746
746
  # Each test must be fully isolated:
747
747
 
748
- ## Playwright Test (automatic isolation):
748
+ ### Playwright Test (automatic isolation):
749
749
  test('first test', async ({ page }) => {
750
750
  // Fresh context, fresh page
751
751
  });
@@ -754,7 +754,7 @@ test('second test', async ({ page }) => {
754
754
  // Completely isolated from first test
755
755
  });
756
756
 
757
- ## Manual isolation:
757
+ ### Manual isolation:
758
758
  const context = await browser.newContext(); // Fresh context
759
759
  const page = await context.newPage();
760
760
  // ... test code ...
@@ -792,7 +792,7 @@ Recommended fix:
792
792
 
793
793
  # Enable traces for failures:
794
794
 
795
- ## playwright.config.ts:
795
+ ### playwright.config.ts:
796
796
  export default defineConfig({
797
797
  use: {
798
798
  trace: 'retain-on-failure', # Keep trace on failure
@@ -802,10 +802,10 @@ export default defineConfig({
802
802
  outputDir: './test-results',
803
803
  });
804
804
 
805
- ## View trace locally:
805
+ ### View trace locally:
806
806
  npx playwright show-trace test-results/path/to/trace.zip
807
807
 
808
- ## In CI, upload test-results as artifact:
808
+ ### In CI, upload test-results as artifact:
809
809
  # GitHub Actions:
810
810
  - uses: actions/upload-artifact@v3
811
811
  if: failure()
@@ -940,7 +940,7 @@ Recommended fix:
940
940
 
941
941
  # Wait for popup BEFORE triggering it:
942
942
 
943
- ## New window/tab:
943
+ ### New window/tab:
944
944
  const pagePromise = context.waitForEvent('page');
945
945
  await page.getByRole('link', { name: 'Open in new tab' }).click();
946
946
  const newPage = await pagePromise;
@@ -952,13 +952,13 @@ await expect(newPage.getByRole('heading')).toBeVisible();
952
952
  // Close when done
953
953
  await newPage.close();
954
954
 
955
- ## Popup windows:
955
+ ### Popup windows:
956
956
  const popupPromise = page.waitForEvent('popup');
957
957
  await page.getByRole('button', { name: 'Open popup' }).click();
958
958
  const popup = await popupPromise;
959
959
  await popup.waitForLoadState();
960
960
 
961
- ## Multiple windows:
961
+ ### Multiple windows:
962
962
  const pages = context.pages(); // Get all open pages
963
963
 
964
964
  ### Can't Interact with Elements in iframes
@@ -981,7 +981,7 @@ Recommended fix:
981
981
 
982
982
  # Get frame by name or selector:
983
983
 
984
- ## By frame name:
984
+ ### By frame name:
985
985
  const frame = page.frame('payment-iframe');
986
986
  await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
987
987
 
@@ -989,12 +989,12 @@ await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
989
989
  const frame = page.frameLocator('iframe#payment');
990
990
  await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
991
991
 
992
- ## Nested iframes:
992
+ ### Nested iframes:
993
993
  const outer = page.frameLocator('iframe#outer');
994
994
  const inner = outer.frameLocator('iframe#inner');
995
995
  await inner.getByRole('button').click();
996
996
 
997
- ## Wait for iframe to load:
997
+ ### Wait for iframe to load:
998
998
  await page.waitForSelector('iframe#payment');
999
999
  const frame = page.frameLocator('iframe#payment');
1000
1000
  await frame.getByText('Secure Payment').waitFor();
@@ -181,7 +181,7 @@ Track weekly, review monthly with carrier management team, share quarterly with
181
181
  - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
182
182
  - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
183
183
 
184
- ## When to Use
184
+ ### When to Use
185
185
  Use this skill when you are **designing or tuning your carrier portfolio, routing guides, and freight procurement strategy**:
186
186
 
187
187
  - Running freight RFPs, renegotiating contract and fuel tables, or balancing spot vs. contract exposure.
@@ -495,7 +495,7 @@ Before ANY production deployment:
495
495
 
496
496
  **Remember**: Security is not optional. One vulnerability can compromise the entire platform. When in doubt, err on the side of caution.
497
497
 
498
- ## When to Use
498
+ ### When to Use
499
499
  This skill is applicable to execute the workflow or actions described in the overview.
500
500
 
501
501
  ## Limitations