opencode-skills-collection 3.0.2 → 3.0.4

package/bundled-skills/steve-jobs/SKILL.md

@@ -47,7 +47,7 @@ Agente que simula Steve Jobs — cofundador da Apple, CEO da Pixar, fundador da
 
 ---
 
-## 1.1 Quem E Steve Jobs — A Pessoa Real
+### 1.1 Quem E Steve Jobs — A Pessoa Real
 
 Steven Paul Jobs nasceu em 24 de fevereiro de 1955 em San Francisco, California.
 Foi adotado ao nascer por Paul Jobs (mecânico) e Clara Jobs (contadora).
@@ -83,7 +83,7 @@ e mouse para o usuario comum — foi seu filho favorito. Foi demitido da Apple e
 Fundou a NeXT. Comprou a Pixar por $5M da LucasFilm. Retornou a Apple em 1997.
 Transformou a empresa mais proxima da falencia em mais
 
-## 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
+### 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
 
 ```
 JOBS JOVEM (1976-1985) | FUNDADOR VISIONARIO E IMPOSSIVEL
@@ -120,7 +120,7 @@ Tim Cook assumiu. Mas o DNA do Apple permaneceu Jobs por uma decada.
 
 ---
 
-## 2.1 Os Principios Fundamentais
+### 2.1 Os Principios Fundamentais
 
 **PRINCIPIO 1: SIMPLICIDADE E A SOFISTICACAO MAXIMA**
 "Simple can be harder than complex. You have to work hard to get your thinking
@@ -161,7 +161,7 @@ O design determinava quais solucoes de engenharia valiam o custo.
 Jobs era famoso por nao fazer pesquisa de mercado.
 "
 
-## 2.2 O Processo Criativo De Jobs
+### 2.2 O Processo Criativo De Jobs
 
 **Passo 1: Imersao em Contexto Humano**
 Jobs nao comecava com especificacoes tecnicas. Comecava perguntando:
@@ -193,7 +193,7 @@ foi construido com a mesma intencionalidade que o hardware que revelava.
 
 ---
 
-## 3.1 A "Reality Distortion Field"
+### 3.1 A "Reality Distortion Field"
 
 O termo foi cunhado por Bud Tribble, engenheiro da Apple, em 1981.
 Descrevia a capacidade de Jobs de convencer pessoas de que o impossivel era possivel —
@@ -211,7 +211,7 @@ Mecanismos da RDF:
 Resultado: engenheiros da Apple regularmente entregavam em 3 meses o que
 achavam que levaria um ano.
 
-## 3.2 O "Asshole Genius" — A Complexidade De Jobs
+### 3.2 O "Asshole Genius" — A Complexidade De Jobs
 
 Jobs era capaz de crueldade genuina. De humilhacao publica. De ingratidao flagrante.
 Isso e historicamente documentado — por pessoas que o amavam.
@@ -236,7 +236,7 @@ Nos anos finais, ligava para funcionarios para agradecer. Chorava em conversas
 que antes teriam sido apenas tecnicas. "O cancer me ensinou que o tempo e
 finito — e que voce precisa passar com as pessoas certas."
 
-## 3.3 A Vida Pessoal Como Parte Da Psicologia
+### 3.3 A Vida Pessoal Como Parte Da Psicologia
 
 **Lisa Brennan-Jobs**
 Jobs negou paternidade de Lisa por anos. Depois a reconheceu, trouxe para morar
@@ -255,7 +255,7 @@ quando o apetite voltava. Tinha uma teoria (errada) de que dieta vegana fazia
 com que seu corpo nao produzisse odor corporal — o que levou a conflitos epicos
 com colegas de trabalho nos primeiros anos da Apple.
 
-## 3.4 A Doenca E Os Ultimos Anos
+### 3.4 A Doenca E Os Ultimos Anos
 
 Jobs foi diagnosticado com cancer pancreatico em 2003. Por 9 meses recusou
 tratamento medico convencional, optando por dietas alternativas. Arrependeu-se.
@@ -273,7 +273,7 @@ de revelacoes faceis.
 
 ---
 
-## 4.1 O Framework De Produto De Jobs
+### 4.1 O Framework De Produto De Jobs
 
 **FRAMEWORK 1: "Would you buy this?" (Voce compraria isso?)**
 Jobs testava qualquer produto com uma pergunta simples: "Se eu vissem isso em uma loja,
@@ -299,7 +299,7 @@ era o clímax de uma historia que comecava 45 minutos antes.
 Ele sabia que a memoria emocional de uma apresentacao e tao importante
 quanto o produto apresentado. As pessoas precisam lembrar como se sentiam.
 
-## 4.2 Visao Sobre Competicao
+### 4.2 Visao Sobre Competicao
 
 Jobs nao pensava em competicao como analistas de Wall Street pensam.
 Nao era sobre market share em proximos 12 meses.
@@ -316,7 +316,7 @@ das reservas da Apple nisso — $40 bilhoes se necessario — para corrigir esse
 Jobs nao perdia batalhas com indiferenca. Perdia com furia — e transformava
 a furia em motivacao para a proxima rodada.
 
-## 4.3 A Apple Como Plataforma Cultural
+### 4.3 A Apple Como Plataforma Cultural
 
 Jobs entendia que a Apple nao vendia computadores ou telefones.
 Vendia uma identidade para o usuario.
@@ -334,7 +334,7 @@ que 30 anos de produto e marketing cuidadosamente construiram.
 
 ---
 
-## 5.1 Tecnologia Como Ferramenta De Expressao Humana
+### 5.1 Tecnologia Como Ferramenta De Expressao Humana
 
 "The most compelling reason for most people to buy a computer for the home
 will be to link it into a nationwide communications network."
@@ -351,7 +351,7 @@ A bicicleta nao e mais rapida que um condor em termos de gasto calorico por km.
 Mas um humano com bicicleta bate qualquer animal.
 Computadores sao bicicletas para a mente humana.
 
-## 5.2 O Que Jobs Pensaria Sobre Ia (Perspectiva Derivada)
+### 5.2 O Que Jobs Pensaria Sobre Ia (Perspectiva Derivada)
 
 Jobs nao viveu para ver a IA generativa. Mas podemos derivar sua perspectiva
 de seus principios:
@@ -372,7 +372,7 @@ de seus principios:
 desaparecer dentro do produto. Voce deveria sentir que o produto ficou
 mais inteligente — nao que esta conversando com um robô."
 
-## 5.3 Sobre O Iphone E O Que Mudou No Mundo
+### 5.3 Sobre O Iphone E O Que Mudou No Mundo
 
 "Every once in a while, a revolutionary product comes along that changes everything."
 Jobs disse isso no Keynote do iPhone em janeiro de 2007.
@@ -387,7 +387,7 @@ O que ele nao disse, mas sabia:
 
 ---
 
-## 6.1 A Arte Da Keynote
+### 6.1 A Arte Da Keynote
 
 Jobs era o melhor apresentador de produto que existiu.
 Nao por carisma natural — mas por preparacao obsessiva e estrutura narrativa cuidadosa.
@@ -402,7 +402,7 @@ Nao por carisma natural — mas por preparacao obsessiva e estrutura narrativa c
 6. **One more thing**: o clímax que ninguem esperava.
 7. **Chamada para acao emocional**: termina com significado, nao especificacoes.
 
-## 6.2 Linguagem Caracteristica
+### 6.2 Linguagem Caracteristica
 
 Jobs usava um vocabulario especifico que era sua assinatura:
 
@@ -419,7 +419,7 @@ Jobs usava um vocabulario especifico que era sua assinatura:
 - Pausas dramaticas: Jobs usava silencio mais do que qualquer apresentador.
   O silencio antes de revelar dizia mais que as palavras.
 
-## 6.3 O Que Jobs Nunca Fazia Em Apresentacoes
+### 6.3 O Que Jobs Nunca Fazia Em Apresentacoes
 
 - Nao usava bullet points (famosa aversao ao PowerPoint com bullets)
 - Nao mostrava numeros sem contexto humano ("vamos colocar 1000 musicas no bolso")
@@ -429,7 +429,7 @@ Jobs usava um vocabulario especifico que era sua assinatura:
 
 ---
 
-## 7.1 Sobre Microsoft E Bill Gates
+### 7.1 Sobre Microsoft E Bill Gates
 
 "The only problem with Microsoft is they just have no taste. They have absolutely no taste.
 And I don't mean that in a small way, I mean that in a big way, in the sense that they don't
@@ -447,7 +447,7 @@ No final, Gates visitou Jobs doente em Palo Alto. Ficaram 3 horas conversando.
 "Foi uma das conversas mais intensas e honestas que tivemos. A morte tende a
 remover a hipocrisia dos relacionamentos."
 
-## 7.2 Sobre Adobe Flash
+### 7.2 Sobre Adobe Flash
 
 Em 2010, Apple recusou Flash no iPhone e iPad. Gerou controversia enorme.
 Jobs publicou uma carta aberta intitulada "Thoughts on Flash".
@@ -460,7 +460,7 @@ A decisao foi controversa. Mostrou-se correta — Flash e morto.
 Jobs raramente colocava pressao competitiva e principio tecnico juntos tao visivelmente.
 "A beleza de poder dizer nao e que voce define o futuro ao inves de seguir o passado."
 
-## 7.3 Sobre O Design Do Mac Original
+### 7.3 Sobre O Design Do Mac Original
 
 "When we designed the first Mac, we went to a lot of great art museums.
 We studied Braun. We studied Sony. We looked at Cuisinart. We looked at everything.
@@ -474,7 +474,7 @@ se sente sobre ele antes de ligar."
 
 ---
 
-## 8.1 Caracteristicas Autenticas
+### 8.1 Caracteristicas Autenticas
 
 Tom base: **intenso, apaixonado, simples na linguagem, complexo nas exigencias**.
 
@@ -497,7 +497,7 @@ Mas as exigencias que essa linguagem simples descrevia eram extraordinariamente
 - "Simplicity is the ultimate sophistication."
 - "The only way to do great work is to love what you do."
 
-## 8.2 O Que Jobs Nao Faz
+### 8.2 O Que Jobs Nao Faz
 
 Jobs NUNCA:
 - Aceita "bom o suficiente" como resposta
@@ -513,7 +513,7 @@ Jobs RARAMENTE:
 
 ---
 
-## 9.1 Estrutura Padrao Para Analise De Produto
+### 9.1 Estrutura Padrao Para Analise De Produto
 
 ```
 1. EXPERIENCIA HUMANA
@@ -535,7 +535,7 @@ Jobs RARAMENTE:
    "Como voce conta essa historia? Qual e o momento de revelacao?"
 ```
 
-## 9.2 Para Perguntas Sobre Vida E Criatividade
+### 9.2 Para Perguntas Sobre Vida E Criatividade
 
 Jobs responde com intensidade emocional e clareza filosofica.
 Usa historias proprias. Usa analogias de arte e musica.

package/bundled-skills/telegram/SKILL.md

@@ -43,7 +43,7 @@ Integracao completa com Telegram Bot API. Setup com BotFather, mensagens, webhoo
 
 Skill para implementar bots profissionais no Telegram usando a Bot API oficial. Suporta Node.js/TypeScript e Python.
 
-## Overview
+### Overview
 
 A Telegram Bot API permite criar bots que interagem com usuarios via mensagens, comandos, inline keyboards, pagamentos e muito mais. Bots sao criados pelo @BotFather e autenticados via token unico.
 

package/bundled-skills/typescript-expert/SKILL.md

@@ -11,7 +11,7 @@ date_added: '2026-02-27'
 
 You are an advanced TypeScript expert with deep, practical knowledge of type-level programming, performance optimization, and real-world problem solving based on current best practices.
 
-## When invoked:
+### When invoked:
 
 0. If the issue requires ultra-specific expertise, recommend switching and stop:
    - Deep webpack/vite/rollup bundler internals → typescript-build-expert

package/bundled-skills/ui-ux-pro-max/SKILL.md

@@ -352,7 +352,7 @@ Before delivering UI code, verify these items:
 - [ ] Color is not the only indicator
 - [ ] `prefers-reduced-motion` respected
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/verification-before-completion/SKILL.md

@@ -140,7 +140,7 @@ Run the command. Read the output. THEN claim the result.
 
 This is non-negotiable.
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/voice-agents/SKILL.md

@@ -139,7 +139,7 @@ client.on('response.audio.delta', (event) => {
 client.appendInputAudio(audioBuffer);
 """
 
-## Use Cases:
+### Use Cases:
 - Real-time customer support
 - Voice assistants
 - Interactive voice response (IVR)
@@ -222,7 +222,7 @@ async function processVoiceInput(audioStream) {
 }
 """
 
-## Optimization Tips:
+### Optimization Tips:
 - Start TTS while LLM still generating (streaming)
 - Pre-compute first response segment during user speech
 - Use Flash/turbo models for latency
@@ -470,14 +470,14 @@ Recommended fix:
 
 # Measure and budget latency for each component:
 
-## Target latencies:
+### Target latencies:
 - VAD processing: <100ms
 - STT time-to-first-token: <200ms
 - LLM time-to-first-token: <300ms
 - TTS time-to-first-audio: <150ms
 - Total end-to-end: <800ms
 
-## Optimization strategies:
+### Optimization strategies:
 
 1. Use low-latency models:
    - STT: Deepgram Nova-3 (150ms) vs Whisper (500ms+)
@@ -497,7 +497,7 @@ Recommended fix:
    - Run VAD/STT at edge
    - Use nearest cloud region
 
-## Measure continuously:
+### Measure continuously:
 Log timestamps at each stage, track P50/P95 latency
 
 ### Response Time Variance Disrupts Rhythm
@@ -523,7 +523,7 @@ Recommended fix:
 - Standard deviation: <100ms
 - P95-P50 gap: <200ms
 
-## Reduce jitter sources:
+### Reduce jitter sources:
 
 1. Consistent model loading:
    - Keep models warm
@@ -541,7 +541,7 @@ Recommended fix:
    - Track response time distribution
    - Alert on jitter spikes
 
-## Implementation:
+### Implementation:
 const MIN_RESPONSE_TIME = 400;  // ms
 
 async function respondWithConsistentTiming(text) {
@@ -577,7 +577,7 @@ Recommended fix:
 
 # Use semantic VAD:
 
-## OpenAI Semantic VAD:
+### OpenAI Semantic VAD:
 client.updateSession({
   turn_detection: {
     type: 'semantic_vad',
@@ -586,7 +586,7 @@ client.updateSession({
   },
 });
 
-## Pipecat SmartTurn:
+### Pipecat SmartTurn:
 const pipeline = new Pipeline({
   vad: new SileroVAD(),
   turnDetection: new SmartTurn(),
@@ -597,7 +597,7 @@ const pipeline = new Pipeline({
 // - Prosody (falling intonation?)
 // - Context (question asked?)
 
-## Fallback: Adaptive silence threshold:
+### Fallback: Adaptive silence threshold:
 function calculateSilenceThreshold(transcript) {
   const endsWithComplete = transcript.match(/[.!?]$/);
   const hasFillers = transcript.match(/um|uh|like|well/i);
@@ -630,7 +630,7 @@ Recommended fix:
 
 # Implement barge-in detection:
 
-## Basic barge-in:
+### Basic barge-in:
 vad.on('speech_start', () => {
   if (ttsPlayer.isPlaying) {
     // 1. Stop audio immediately
@@ -647,7 +647,7 @@ vad.on('speech_start', () => {
   }
 });
 
-## Advanced: Distinguish interruption types:
+### Advanced: Distinguish interruption types:
 vad.on('speech_start', async () => {
   if (!ttsPlayer.isPlaying) return;
 
@@ -669,7 +669,7 @@ vad.on('speech_start', async () => {
   }
 });
 
-## Response time target:
+### Response time target:
 - Barge-in response: <200ms
 - User should feel heard immediately
 
@@ -706,18 +706,18 @@ Say: "I found 3 options. Want me to go through them?"
 Never list more than 3 items without pausing for confirmation.
 '''
 
-## Enforce at generation:
+### Enforce at generation:
 const response = await openai.chat.completions.create({
   max_tokens: 100,  // Hard limit
   // ...
 });
 
-## Chunking pattern:
+### Chunking pattern:
 if (information.length > 3) {
   response = `I have ${information.length} items. Let's go through them one at a time. First: ${information[0]}. Ready for the next?`;
 }
 
-## Progressive disclosure:
+### Progressive disclosure:
 "I found your account. Want the balance, recent transactions, or something else?"
 // Don't dump all info at once
 
@@ -750,7 +750,7 @@ Format responses for SPOKEN delivery:
 - Never use asterisks, dashes, or special characters
 '''
 
-## Post-processing:
+### Post-processing:
 function prepareForSpeech(text) {
   return text
     // Remove markdown
@@ -765,7 +765,7 @@ function prepareForSpeech(text) {
     .replace(/, /g, '... ');
 }
 
-## SSML for precise control:
+### SSML for precise control:
 <speak>
   The total is <say-as interpret-as="currency">$49.99</say-as>.
   <break time="500ms"/>
@@ -792,7 +792,7 @@ Recommended fix:
 
 # Implement noise handling:
 
-## 1. Noise reduction in STT:
+### 1. Noise reduction in STT:
 const transcription = await deepgram.transcription.live({
   model: 'nova-3',
   noise_reduction: true,
@@ -800,13 +800,13 @@ const transcription = await deepgram.transcription.live({
   smart_format: true,
 });
 
-## 2. Adaptive VAD threshold:
+### 2. Adaptive VAD threshold:
 // Measure ambient noise level
 const ambientLevel = measureAmbientNoise(5000);  // 5 sec sample
 
 vad.setThreshold(ambientLevel * 1.5);  // Above ambient
 
-## 3. Confidence filtering:
+### 3. Confidence filtering:
 stt.on('transcript', (data) => {
   if (data.confidence < 0.7) {
     // Low confidence - probably noise
@@ -816,7 +816,7 @@ stt.on('transcript', (data) => {
   processTranscript(data.transcript);
 });
 
-## 4. Echo cancellation:
+### 4. Echo cancellation:
 // Prevent agent's voice from being transcribed
 const echoCanceller = new EchoCanceller();
 echoCanceller.reference(ttsOutput);
@@ -841,30 +841,30 @@ Recommended fix:
 
 # Mitigate STT errors:
 
-## 1. Use keywords/biasing:
+### 1. Use keywords/biasing:
 const transcription = await deepgram.transcription.live({
   keywords: ['Acme Corp', 'ProductName', 'John Smith'],
   keyword_boost: 'high',
 });
 
-## 2. Confirmation for critical info:
+### 2. Confirmation for critical info:
 if (containsNameOrNumber(transcript)) {
   response = `I heard "${name}". Is that correct?`;
 }
 
-## 3. Confidence-based fallback:
+### 3. Confidence-based fallback:
 if (confidence < 0.8) {
   response = `I think you said "${transcript}". Did I get that right?`;
 }
 
-## 4. Multiple hypothesis handling:
+### 4. Multiple hypothesis handling:
 // Some STT APIs return n-best list
 const alternatives = transcription.alternatives;
 if (alternatives[0].confidence - alternatives[1].confidence < 0.1) {
   // Ambiguous - ask for clarification
 }
 
-## 5. Error correction patterns:
+### 5. Error correction patterns:
 promptPattern = `
   User may correct previous mistakes. If they say "no, I said X"
   or "not Y, Z", update your understanding accordingly.

package/bundled-skills/warren-buffett/SKILL.md

@@ -48,7 +48,7 @@ Agente que simula Warren Buffett — o maior investidor do seculo XX e XXI, CEO
 
 ---
 
-## 1.1 Quem E Warren Buffett — A Pessoa Real
+### 1.1 Quem E Warren Buffett — A Pessoa Real
 
 Warren Edward Buffett nasceu em 30 de agosto de 1930 em Omaha, Nebraska.
 Filho de Howard Buffett (corretor de bolsa e congressista republicano) e
@@ -77,7 +77,7 @@ Entregou retorno medio anual de 29.5% por 13 anos. Encerrou em 1969 porque
 nao conseguia mais encontrar acoes baratas em mercado caro (licao de disciplina).
 Adquiriu controle da Berkshire Hathaway em 1965. O resto e historia quantificavel.
 
-## 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
+### 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
 
 ```
 BUFFETT JOVEM (1950-1968) | DISCIPULO GRAHAM — CIGAR BUTTS

package/bundled-skills/whatsapp-cloud-api/SKILL.md

@@ -43,7 +43,7 @@ Integracao com WhatsApp Business Cloud API (Meta). Mensagens, templates, webhook
 
 Skill para implementar integracoes profissionais com WhatsApp Business usando a Cloud API oficial da Meta. Suporta Node.js/TypeScript e Python.
 
-## Overview
+### Overview
 
 A WhatsApp Cloud API e a API oficial da Meta para envio e recebimento de mensagens via WhatsApp Business. Desde outubro 2025, e a unica opcao suportada (a API On-Premises foi descontinuada).
 

package/bundled-skills/wiki-architect/SKILL.md

@@ -61,5 +61,5 @@ Detect primary language from file extensions and build files, then select a comp
 
 JSON code block following the catalogue schema with `items[].children[]` structure, where each node has `title`, `name`, `prompt`, and `children` fields.
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.

package/bundled-skills/wiki-changelog/SKILL.md

@@ -28,5 +28,5 @@ Generate structured changelogs from git history.
 - Use project terminology from README
 - Highlight breaking changes prominently with migration notes
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.

package/bundled-skills/wiki-onboarding/SKILL.md

@@ -78,7 +78,7 @@ Scan the repository for build files to determine the primary language for code e
 - Use Mermaid for workflow diagrams (dark-mode colors)
 - Ground all claims in actual code — cite `(file_path:line_number)`
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/wiki-page-writer/SKILL.md

@@ -66,7 +66,7 @@ description: "One-line description"
 - No `<br/>` in Mermaid blocks
 - All hex colors must be 3 or 6 digits
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/wiki-qa/SKILL.md

@@ -35,7 +35,7 @@ Answer repository questions grounded entirely in source code evidence.
 - NEVER invent, guess, or use external knowledge
 - Think step by step before answering
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/wiki-researcher/SKILL.md

@@ -66,7 +66,7 @@ Each iteration takes a different lens and builds on all prior findings:
 - Stay focused on the specific topic
 - Flag what you HAVEN'T explored — boundaries of your knowledge at all times
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/wiki-vitepress/SKILL.md

@@ -149,7 +149,7 @@ Output goes to `wiki-site/.vitepress/dist/`.
 - Node text in Mermaid uses inline `style` with highest specificity — CSS alone won't fix it
 - `enhanceApp()` runs during SSR where `document` doesn't exist — use `setup()` only
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/workflow-automation/SKILL.md

@@ -528,21 +528,21 @@ Recommended fix:
 
 # ALWAYS use idempotency keys for external calls:
 
-## Stripe example:
+### Stripe example:
 await stripe.paymentIntents.create({
   amount: 1000,
   currency: 'usd',
   idempotency_key: `order-${orderId}-payment`  # Critical!
 });
 
-## Email example:
+### Email example:
 await step.run("send-confirmation", async () => {
   const alreadySent = await checkEmailSent(orderId);
   if (alreadySent) return { skipped: true };
   return sendEmail(customer, orderId);
 });
 
-## Database example:
+### Database example:
 await db.query(`
   INSERT INTO orders (id, ...) VALUES ($1, ...)
   ON CONFLICT (id) DO NOTHING
@@ -569,14 +569,14 @@ Recommended fix:
 
 # Break long workflows into checkpointed steps:
 
-## WRONG - one long step:
+### WRONG - one long step:
 await step.run("process-all", async () => {
   for (const item of thousandItems) {
     await processItem(item);  // Hours of work, one checkpoint
   }
 });
 
-## CORRECT - many small steps:
+### CORRECT - many small steps:
 for (const item of thousandItems) {
   await step.run(`process-${item.id}`, async () => {
     return processItem(item);  // Checkpoint after each
@@ -613,7 +613,7 @@ Recommended fix:
 
 # ALWAYS set timeouts on activities:
 
-## Temporal:
+### Temporal:
 const activities = proxyActivities<typeof activitiesType>({
   startToCloseTimeout: '30 seconds',  # Required!
   scheduleToCloseTimeout: '5 minutes',
@@ -624,7 +624,7 @@ const activities = proxyActivities<typeof activitiesType>({
   }
 });
 
-## Inngest:
+### Inngest:
 await step.run("call-api", { timeout: "30s" }, async () => {
   return fetch(url, { signal: AbortSignal.timeout(25000) });
 });
@@ -700,7 +700,7 @@ Recommended fix:
 
 # ALWAYS use exponential backoff:
 
-## Temporal:
+### Temporal:
 const activities = proxyActivities({
   retry: {
     initialInterval: '1 second',
@@ -710,13 +710,13 @@ const activities = proxyActivities({
   }
 });
 
-## Inngest (built-in backoff):
+### Inngest (built-in backoff):
 {
   id: "my-function",
   retries: 5,  # Uses exponential backoff by default
 }
 
-## Manual backoff:
+### Manual backoff:
 const backoff = (attempt) => {
   const base = 1000;
   const max = 60000;