[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F99CDJAWNQYA1A1DBXZZ1Z":3,"skill-same:01M6F99CDJAWNQYA1A1DBXZZ1Z":80},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":48,"linkOnly":49,"markdownContent":50,"markdownBody":51,"frontMatter":52,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":60,"repositoryHtmlUrl":61,"repositoryHomepageUrl":6,"ownerHtmlUrl":62,"ownerBlogUrl":63,"ownerDescription":64,"updatedAt":65,"install":66,"resources":79},"01M6F99CDJAWNQYA1A1DBXZZ1Z","speak-performance-tuning",null,"Optimize Speak API performance with caching, audio preprocessing, and connection pooling.\nUse when experiencing slow API responses, implementing caching strategies,\nor optimizing request throughput for language learning applications.\nTrigger with phrases like \"speak performance\", \"optimize speak\",\n\"speak latency\", \"speak caching\", \"speak slow\", \"speak audio optimization\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fspeak-pack\u002Fskills\u002Fspeak-performance-tuning\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47],"tuning","speak","speak performance tuning","performance tuning","performance","strategies","when","request","pooling","implementing","throughput","io","latency","preprocessing","connection pooling","caching","optimize","language learning","edit","write","read","Audio","api","Optimization","2026-11-10 10:12:30",false,"---\nname: speak-performance-tuning\ndescription: |\n  Optimize Speak API performance with caching, audio preprocessing, and connection pooling.\n  Use when experiencing slow API responses, implementing caching strategies,\n  or optimizing request throughput for language learning applications.\n  Trigger with phrases like \"speak performance\", \"optimize speak\",\n  \"speak latency\", \"speak caching\", \"speak slow\", \"speak audio optimization\".\nallowed-tools: Read, Write, Edit\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Speak Performance Tuning\n\n## Overview\nOptimize Speak API performance with caching, audio preprocessing, and connection pooling for language learning applications.\n\n## Prerequisites\n- Speak SDK installed\n- Understanding of async patterns\n- Redis or in-memory cache available (optional)\n- Performance monitoring in place\n\n## Latency Benchmarks\n\n| Operation | P50 | P95 | P99 |\n|-----------|-----|-----|-----|\n| Session Start | 200ms | 500ms | 1000ms |\n| Tutor Prompt | 150ms | 300ms | 600ms |\n| Text Response Submit | 100ms | 250ms | 500ms |\n| Audio Recognition | 500ms | 1500ms | 3000ms |\n| Pronunciation Scoring | 800ms | 2000ms | 4000ms |\n\n## Audio Optimization\n\n### Pre-processing Audio Before Upload\n```typescript\nclass AudioOptimizer {\n  \u002F\u002F Optimize audio for Speak's speech recognition\n  async optimizeForRecognition(audioData: ArrayBuffer): Promise\u003CArrayBuffer> {\n    \u002F\u002F Convert to optimal format: 16kHz mono PCM WAV\n    const audioContext = new AudioContext({ sampleRate: 16000 });\n    const audioBuffer = await audioContext.decodeAudioData(audioData);\n\n    \u002F\u002F Convert to mono if stereo\n    const monoBuffer = this.toMono(audioBuffer);\n\n    \u002F\u002F Normalize audio levels\n    const normalizedBuffer = this.normalize(monoBuffer);\n\n    \u002F\u002F Remove silence at start\u002Fend\n    const trimmedBuffer = this.trimSilence(normalizedBuffer);\n\n    \u002F\u002F Encode as WAV\n    return this.encodeWav(trimmedBuffer);\n  }\n\n  private toMono(buffer: AudioBuffer): AudioBuffer {\n    if (buffer.numberOfChannels === 1) return buffer;\n\n    const monoData = new Float32Array(buffer.length);\n    const left = buffer.getChannelData(0);\n    const right = buffer.getChannelData(1);\n\n    for (let i = 0; i \u003C buffer.length; i++) {\n      monoData[i] = (left[i] + right[i]) \u002F 2;\n    }\n\n    const ctx = new OfflineAudioContext(1, buffer.length, buffer.sampleRate);\n    const newBuffer = ctx.createBuffer(1, buffer.length, buffer.sampleRate);\n    newBuffer.copyToChannel(monoData, 0);\n    return newBuffer;\n  }\n\n  private normalize(buffer: AudioBuffer): AudioBuffer {\n    const data = buffer.getChannelData(0);\n    let max = 0;\n\n    for (let i = 0; i \u003C data.length; i++) {\n      max = Math.max(max, Math.abs(data[i]));\n    }\n\n    if (max > 0 && max \u003C 0.9) {\n      const factor = 0.9 \u002F max;\n      for (let i = 0; i \u003C data.length; i++) {\n        data[i] *= factor;\n      }\n    }\n\n    return buffer;\n  }\n\n  private trimSilence(buffer: AudioBuffer, threshold = 0.01): AudioBuffer {\n    const data = buffer.getChannelData(0);\n    let start = 0;\n    let end = data.length;\n\n    \u002F\u002F Find start\n    for (let i = 0; i \u003C data.length; i++) {\n      if (Math.abs(data[i]) > threshold) {\n        start = Math.max(0, i - 1000); \u002F\u002F Keep small buffer\n        break;\n      }\n    }\n\n    \u002F\u002F Find end\n    for (let i = data.length - 1; i >= 0; i--) {\n      if (Math.abs(data[i]) > threshold) {\n        end = Math.min(data.length, i + 1000);\n        break;\n      }\n    }\n\n    const trimmedLength = end - start;\n    const ctx = new OfflineAudioContext(1, trimmedLength, buffer.sampleRate);\n    const newBuffer = ctx.createBuffer(1, trimmedLength, buffer.sampleRate);\n    newBuffer.copyToChannel(data.slice(start, end), 0);\n    return newBuffer;\n  }\n}\n```\n\n### Streaming Audio for Real-time Recognition\n```typescript\nclass StreamingRecognizer {\n  private chunks: ArrayBuffer[] = [];\n  private processingPromise: Promise\u003Cvoid> | null = null;\n\n  async streamAudioChunk(chunk: ArrayBuffer): Promise\u003CPartialResult | null> {\n    this.chunks.push(chunk);\n\n    \u002F\u002F Process in batches to reduce API calls\n    if (this.chunks.length >= 5 || this.shouldProcess()) {\n      return this.processAccumulated();\n    }\n\n    return null;\n  }\n\n  private async processAccumulated(): Promise\u003CPartialResult> {\n    const combinedSize = this.chunks.reduce((sum, c) => sum + c.byteLength, 0);\n    const combined = new ArrayBuffer(combinedSize);\n    const view = new Uint8Array(combined);\n\n    let offset = 0;\n    for (const chunk of this.chunks) {\n      view.set(new Uint8Array(chunk), offset);\n      offset += chunk.byteLength;\n    }\n\n    this.chunks = [];\n\n    const result = await speakClient.speech.recognizeStream(combined);\n    return result;\n  }\n}\n```\n\n## Caching Strategy\n\n### Response Caching for Static Content\n```typescript\nimport { LRUCache } from 'lru-cache';\n\n\u002F\u002F Cache tutor prompts and audio URLs\nconst promptCache = new LRUCache\u003Cstring, TutorPrompt>({\n  max: 500,\n  ttl: 60 * 60 * 1000, \u002F\u002F 1 hour\n  updateAgeOnGet: true,\n});\n\n\u002F\u002F Cache vocabulary lookups\nconst vocabularyCache = new LRUCache\u003Cstring, VocabularyEntry>({\n  max: 10000,\n  ttl: 24 * 60 * 60 * 1000, \u002F\u002F 24 hours\n});\n\nasync function getCachedVocabulary(\n  word: string,\n  language: string\n): Promise\u003CVocabularyEntry> {\n  const key = `${language}:${word}`;\n  const cached = vocabularyCache.get(key);\n  if (cached) return cached;\n\n  const entry = await speakClient.vocabulary.lookup(word, language);\n  vocabularyCache.set(key, entry);\n  return entry;\n}\n```\n\n### Redis Caching for Distributed Systems\n```typescript\nimport Redis from 'ioredis';\n\nconst redis = new Redis(process.env.REDIS_URL);\n\nasync function cachedWithRedis\u003CT>(\n  key: string,\n  fetcher: () => Promise\u003CT>,\n  ttlSeconds = 3600\n): Promise\u003CT> {\n  const cached = await redis.get(key);\n  if (cached) {\n    return JSON.parse(cached);\n  }\n\n  const result = await fetcher();\n  await redis.setex(key, ttlSeconds, JSON.stringify(result));\n  return result;\n}\n\n\u002F\u002F Cache user progress\nasync function getUserProgress(userId: string): Promise\u003CUserProgress> {\n  return cachedWithRedis(\n    `speak:progress:${userId}`,\n    () => speakClient.users.getProgress(userId),\n    300 \u002F\u002F 5 minutes\n  );\n}\n```\n\n### Audio Asset Caching\n```typescript\n\u002F\u002F Pre-fetch and cache audio assets\nclass AudioAssetCache {\n  private cache: Map\u003Cstring, ArrayBuffer> = new Map();\n  private preloadQueue: Set\u003Cstring> = new Set();\n\n  async preloadLessonAudio(lessonId: string): Promise\u003Cvoid> {\n    const lesson = await speakClient.lessons.get(lessonId);\n\n    \u002F\u002F Pre-fetch all audio for the lesson\n    const audioUrls = lesson.items.map(item => item.audioUrl);\n\n    await Promise.all(\n      audioUrls.map(async (url) => {\n        if (!this.cache.has(url) && !this.preloadQueue.has(url)) {\n          this.preloadQueue.add(url);\n          const response = await fetch(url);\n          const buffer = await response.arrayBuffer();\n          this.cache.set(url, buffer);\n          this.preloadQueue.delete(url);\n        }\n      })\n    );\n  }\n\n  async getAudio(url: string): Promise\u003CArrayBuffer> {\n    const cached = this.cache.get(url);\n    if (cached) return cached;\n\n    const response = await fetch(url);\n    const buffer = await response.arrayBuffer();\n    this.cache.set(url, buffer);\n    return buffer;\n  }\n}\n```\n\n## Connection Optimization\n\n```typescript\nimport { Agent } from 'https';\n\n\u002F\u002F Keep-alive connection pooling\nconst agent = new Agent({\n  keepAlive: true,\n  maxSockets: 10,\n  maxFreeSockets: 5,\n  timeout: 60000,\n});\n\nconst client = new SpeakClient({\n  apiKey: process.env.SPEAK_API_KEY!,\n  appId: process.env.SPEAK_APP_ID!,\n  httpAgent: agent,\n  timeout: 30000,\n});\n```\n\n## Request Batching\n\n```typescript\nimport DataLoader from 'dataloader';\n\n\u002F\u002F Batch vocabulary lookups\nconst vocabularyLoader = new DataLoader\u003Cstring, VocabularyEntry>(\n  async (words) => {\n    \u002F\u002F Batch API call\n    const results = await speakClient.vocabulary.batchLookup(words);\n    return words.map(word => results.find(r => r.word === word) || null);\n  },\n  {\n    maxBatchSize: 50,\n    batchScheduleFn: callback => setTimeout(callback, 50),\n  }\n);\n\n\u002F\u002F Usage - automatically batched\nconst [word1, word2, word3] = await Promise.all([\n  vocabularyLoader.load('hola'),\n  vocabularyLoader.load('buenos'),\n  vocabularyLoader.load('días'),\n]);\n```\n\n## Performance Monitoring\n\n```typescript\ninterface SpeakMetrics {\n  operation: string;\n  duration: number;\n  success: boolean;\n  audioSize?: number;\n}\n\nasync function measuredSpeakCall\u003CT>(\n  operation: string,\n  fn: () => Promise\u003CT>,\n  metadata?: Record\u003Cstring, any>\n): Promise\u003CT> {\n  const start = performance.now();\n  try {\n    const result = await fn();\n    const duration = performance.now() - start;\n\n    \u002F\u002F Log metrics\n    console.log({\n      operation,\n      duration,\n      success: true,\n      ...metadata,\n    });\n\n    \u002F\u002F Track in metrics system\n    metrics.histogram('speak_api_duration', duration, { operation });\n    metrics.increment('speak_api_success', { operation });\n\n    return result;\n  } catch (error) {\n    const duration = performance.now() - start;\n\n    console.error({\n      operation,\n      duration,\n      success: false,\n      error,\n      ...metadata,\n    });\n\n    metrics.histogram('speak_api_duration', duration, { operation });\n    metrics.increment('speak_api_error', { operation });\n\n    throw error;\n  }\n}\n\n\u002F\u002F Usage\nconst result = await measuredSpeakCall(\n  'speech.recognize',\n  () => speakClient.speech.recognize(audioBuffer),\n  { audioSize: audioBuffer.byteLength }\n);\n```\n\n## Output\n- Reduced API latency\n- Audio preprocessing pipeline\n- Caching layer implemented\n- Request batching enabled\n- Connection pooling configured\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Cache miss storm | TTL expired | Use stale-while-revalidate |\n| Audio too large | No compression | Optimize audio format |\n| Connection exhausted | No pooling | Configure max sockets |\n| Memory pressure | Cache too large | Set max cache entries |\n| Batch timeout | Too many items | Reduce batch size |\n\n## Examples\n\n### Quick Performance Wrapper\n```typescript\nconst withPerformance = \u003CT>(name: string, fn: () => Promise\u003CT>) =>\n  measuredSpeakCall(name, () =>\n    cachedWithRedis(`cache:${name}`, fn, 300)\n  );\n```\n\n## Resources\n- [Speak Performance Guide](https:\u002F\u002Fdeveloper.speak.com\u002Fdocs\u002Fperformance)\n- [Web Audio API](https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Audio_API)\n- [DataLoader Documentation](https:\u002F\u002Fgithub.com\u002Fgraphql\u002Fdataloader)\n- [LRU Cache Documentation](https:\u002F\u002Fgithub.com\u002Fisaacs\u002Fnode-lru-cache)\n\n## Next Steps\nFor cost optimization, see `speak-cost-tuning`.\n","# Speak Performance Tuning\n\n## Overview\nOptimize Speak API performance with caching, audio preprocessing, and connection pooling for language learning applications.\n\n## Prerequisites\n- Speak SDK installed\n- Understanding of async patterns\n- Redis or in-memory cache available (optional)\n- Performance monitoring in place\n\n## Latency Benchmarks\n\n| Operation | P50 | P95 | P99 |\n|-----------|-----|-----|-----|\n| Session Start | 200ms | 500ms | 1000ms |\n| Tutor Prompt | 150ms | 300ms | 600ms |\n| Text Response Submit | 100ms | 250ms | 500ms |\n| Audio Recognition | 500ms | 1500ms | 3000ms |\n| Pronunciation Scoring | 800ms | 2000ms | 4000ms |\n\n## Audio Optimization\n\n### Pre-processing Audio Before Upload\n```typescript\nclass AudioOptimizer {\n  \u002F\u002F Optimize audio for Speak's speech recognition\n  async optimizeForRecognition(audioData: ArrayBuffer): Promise\u003CArrayBuffer> {\n    \u002F\u002F Convert to optimal format: 16kHz mono PCM WAV\n    const audioContext = new AudioContext({ sampleRate: 16000 });\n    const audioBuffer = await audioContext.decodeAudioData(audioData);\n\n    \u002F\u002F Convert to mono if stereo\n    const monoBuffer = this.toMono(audioBuffer);\n\n    \u002F\u002F Normalize audio levels\n    const normalizedBuffer = this.normalize(monoBuffer);\n\n    \u002F\u002F Remove silence at start\u002Fend\n    const trimmedBuffer = this.trimSilence(normalizedBuffer);\n\n    \u002F\u002F Encode as WAV\n    return this.encodeWav(trimmedBuffer);\n  }\n\n  private toMono(buffer: AudioBuffer): AudioBuffer {\n    if (buffer.numberOfChannels === 1) return buffer;\n\n    const monoData = new Float32Array(buffer.length);\n    const left = buffer.getChannelData(0);\n    const right = buffer.getChannelData(1);\n\n    for (let i = 0; i \u003C buffer.length; i++) {\n      monoData[i] = (left[i] + right[i]) \u002F 2;\n    }\n\n    const ctx = new OfflineAudioContext(1, buffer.length, buffer.sampleRate);\n    const newBuffer = ctx.createBuffer(1, buffer.length, buffer.sampleRate);\n    newBuffer.copyToChannel(monoData, 0);\n    return newBuffer;\n  }\n\n  private normalize(buffer: AudioBuffer): AudioBuffer {\n    const data = buffer.getChannelData(0);\n    let max = 0;\n\n    for (let i = 0; i \u003C data.length; i++) {\n      max = Math.max(max, Math.abs(data[i]));\n    }\n\n    if (max > 0 && max \u003C 0.9) {\n      const factor = 0.9 \u002F max;\n      for (let i = 0; i \u003C data.length; i++) {\n        data[i] *= factor;\n      }\n    }\n\n    return buffer;\n  }\n\n  private trimSilence(buffer: AudioBuffer, threshold = 0.01): AudioBuffer {\n    const data = buffer.getChannelData(0);\n    let start = 0;\n    let end = data.length;\n\n    \u002F\u002F Find start\n    for (let i = 0; i \u003C data.length; i++) {\n      if (Math.abs(data[i]) > threshold) {\n        start = Math.max(0, i - 1000); \u002F\u002F Keep small buffer\n        break;\n      }\n    }\n\n    \u002F\u002F Find end\n    for (let i = data.length - 1; i >= 0; i--) {\n      if (Math.abs(data[i]) > threshold) {\n        end = Math.min(data.length, i + 1000);\n        break;\n      }\n    }\n\n    const trimmedLength = end - start;\n    const ctx = new OfflineAudioContext(1, trimmedLength, buffer.sampleRate);\n    const newBuffer = ctx.createBuffer(1, trimmedLength, buffer.sampleRate);\n    newBuffer.copyToChannel(data.slice(start, end), 0);\n    return newBuffer;\n  }\n}\n```\n\n### Streaming Audio for Real-time Recognition\n```typescript\nclass StreamingRecognizer {\n  private chunks: ArrayBuffer[] = [];\n  private processingPromise: Promise\u003Cvoid> | null = null;\n\n  async streamAudioChunk(chunk: ArrayBuffer): Promise\u003CPartialResult | null> {\n    this.chunks.push(chunk);\n\n    \u002F\u002F Process in batches to reduce API calls\n    if (this.chunks.length >= 5 || this.shouldProcess()) {\n      return this.processAccumulated();\n    }\n\n    return null;\n  }\n\n  private async processAccumulated(): Promise\u003CPartialResult> {\n    const combinedSize = this.chunks.reduce((sum, c) => sum + c.byteLength, 0);\n    const combined = new ArrayBuffer(combinedSize);\n    const view = new Uint8Array(combined);\n\n    let offset = 0;\n    for (const chunk of this.chunks) {\n      view.set(new Uint8Array(chunk), offset);\n      offset += chunk.byteLength;\n    }\n\n    this.chunks = [];\n\n    const result = await speakClient.speech.recognizeStream(combined);\n    return result;\n  }\n}\n```\n\n## Caching Strategy\n\n### Response Caching for Static Content\n```typescript\nimport { LRUCache } from 'lru-cache';\n\n\u002F\u002F Cache tutor prompts and audio URLs\nconst promptCache = new LRUCache\u003Cstring, TutorPrompt>({\n  max: 500,\n  ttl: 60 * 60 * 1000, \u002F\u002F 1 hour\n  updateAgeOnGet: true,\n});\n\n\u002F\u002F Cache vocabulary lookups\nconst vocabularyCache = new LRUCache\u003Cstring, VocabularyEntry>({\n  max: 10000,\n  ttl: 24 * 60 * 60 * 1000, \u002F\u002F 24 hours\n});\n\nasync function getCachedVocabulary(\n  word: string,\n  language: string\n): Promise\u003CVocabularyEntry> {\n  const key = `${language}:${word}`;\n  const cached = vocabularyCache.get(key);\n  if (cached) return cached;\n\n  const entry = await speakClient.vocabulary.lookup(word, language);\n  vocabularyCache.set(key, entry);\n  return entry;\n}\n```\n\n### Redis Caching for Distributed Systems\n```typescript\nimport Redis from 'ioredis';\n\nconst redis = new Redis(process.env.REDIS_URL);\n\nasync function cachedWithRedis\u003CT>(\n  key: string,\n  fetcher: () => Promise\u003CT>,\n  ttlSeconds = 3600\n): Promise\u003CT> {\n  const cached = await redis.get(key);\n  if (cached) {\n    return JSON.parse(cached);\n  }\n\n  const result = await fetcher();\n  await redis.setex(key, ttlSeconds, JSON.stringify(result));\n  return result;\n}\n\n\u002F\u002F Cache user progress\nasync function getUserProgress(userId: string): Promise\u003CUserProgress> {\n  return cachedWithRedis(\n    `speak:progress:${userId}`,\n    () => speakClient.users.getProgress(userId),\n    300 \u002F\u002F 5 minutes\n  );\n}\n```\n\n### Audio Asset Caching\n```typescript\n\u002F\u002F Pre-fetch and cache audio assets\nclass AudioAssetCache {\n  private cache: Map\u003Cstring, ArrayBuffer> = new Map();\n  private preloadQueue: Set\u003Cstring> = new Set();\n\n  async preloadLessonAudio(lessonId: string): Promise\u003Cvoid> {\n    const lesson = await speakClient.lessons.get(lessonId);\n\n    \u002F\u002F Pre-fetch all audio for the lesson\n    const audioUrls = lesson.items.map(item => item.audioUrl);\n\n    await Promise.all(\n      audioUrls.map(async (url) => {\n        if (!this.cache.has(url) && !this.preloadQueue.has(url)) {\n          this.preloadQueue.add(url);\n          const response = await fetch(url);\n          const buffer = await response.arrayBuffer();\n          this.cache.set(url, buffer);\n          this.preloadQueue.delete(url);\n        }\n      })\n    );\n  }\n\n  async getAudio(url: string): Promise\u003CArrayBuffer> {\n    const cached = this.cache.get(url);\n    if (cached) return cached;\n\n    const response = await fetch(url);\n    const buffer = await response.arrayBuffer();\n    this.cache.set(url, buffer);\n    return buffer;\n  }\n}\n```\n\n## Connection Optimization\n\n```typescript\nimport { Agent } from 'https';\n\n\u002F\u002F Keep-alive connection pooling\nconst agent = new Agent({\n  keepAlive: true,\n  maxSockets: 10,\n  maxFreeSockets: 5,\n  timeout: 60000,\n});\n\nconst client = new SpeakClient({\n  apiKey: process.env.SPEAK_API_KEY!,\n  appId: process.env.SPEAK_APP_ID!,\n  httpAgent: agent,\n  timeout: 30000,\n});\n```\n\n## Request Batching\n\n```typescript\nimport DataLoader from 'dataloader';\n\n\u002F\u002F Batch vocabulary lookups\nconst vocabularyLoader = new DataLoader\u003Cstring, VocabularyEntry>(\n  async (words) => {\n    \u002F\u002F Batch API call\n    const results = await speakClient.vocabulary.batchLookup(words);\n    return words.map(word => results.find(r => r.word === word) || null);\n  },\n  {\n    maxBatchSize: 50,\n    batchScheduleFn: callback => setTimeout(callback, 50),\n  }\n);\n\n\u002F\u002F Usage - automatically batched\nconst [word1, word2, word3] = await Promise.all([\n  vocabularyLoader.load('hola'),\n  vocabularyLoader.load('buenos'),\n  vocabularyLoader.load('días'),\n]);\n```\n\n## Performance Monitoring\n\n```typescript\ninterface SpeakMetrics {\n  operation: string;\n  duration: number;\n  success: boolean;\n  audioSize?: number;\n}\n\nasync function measuredSpeakCall\u003CT>(\n  operation: string,\n  fn: () => Promise\u003CT>,\n  metadata?: Record\u003Cstring, any>\n): Promise\u003CT> {\n  const start = performance.now();\n  try {\n    const result = await fn();\n    const duration = performance.now() - start;\n\n    \u002F\u002F Log metrics\n    console.log({\n      operation,\n      duration,\n      success: true,\n      ...metadata,\n    });\n\n    \u002F\u002F Track in metrics system\n    metrics.histogram('speak_api_duration', duration, { operation });\n    metrics.increment('speak_api_success', { operation });\n\n    return result;\n  } catch (error) {\n    const duration = performance.now() - start;\n\n    console.error({\n      operation,\n      duration,\n      success: false,\n      error,\n      ...metadata,\n    });\n\n    metrics.histogram('speak_api_duration', duration, { operation });\n    metrics.increment('speak_api_error', { operation });\n\n    throw error;\n  }\n}\n\n\u002F\u002F Usage\nconst result = await measuredSpeakCall(\n  'speech.recognize',\n  () => speakClient.speech.recognize(audioBuffer),\n  { audioSize: audioBuffer.byteLength }\n);\n```\n\n## Output\n- Reduced API latency\n- Audio preprocessing pipeline\n- Caching layer implemented\n- Request batching enabled\n- Connection pooling configured\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Cache miss storm | TTL expired | Use stale-while-revalidate |\n| Audio too large | No compression | Optimize audio format |\n| Connection exhausted | No pooling | Configure max sockets |\n| Memory pressure | Cache too large | Set max cache entries |\n| Batch timeout | Too many items | Reduce batch size |\n\n## Examples\n\n### Quick Performance Wrapper\n```typescript\nconst withPerformance = \u003CT>(name: string, fn: () => Promise\u003CT>) =>\n  measuredSpeakCall(name, () =>\n    cachedWithRedis(`cache:${name}`, fn, 300)\n  );\n```\n\n## Resources\n- [Speak Performance Guide](https:\u002F\u002Fdeveloper.speak.com\u002Fdocs\u002Fperformance)\n- [Web Audio API](https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Audio_API)\n- [DataLoader Documentation](https:\u002F\u002Fgithub.com\u002Fgraphql\u002Fdataloader)\n- [LRU Cache Documentation](https:\u002F\u002Fgithub.com\u002Fisaacs\u002Fnode-lru-cache)\n\n## Next Steps\nFor cost optimization, see `speak-cost-tuning`.\n",{"name":5,"author":53,"license":15,"version":54,"description":55,"allowed-tools":56},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Optimize Speak API performance with caching, audio preprocessing, and connection pooling.\nUse when experiencing slow API responses, implementing caching strategies,\nor optimizing request throughput for language learning applications.\nTrigger with phrases like \"speak performance\", \"optimize speak\",\n\"speak latency\", \"speak caching\", \"speak slow\", \"speak audio optimization\".\n","Read, Write, Edit","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fspeak-pack\u002Fskills\u002Fspeak-performance-tuning",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":67,"prompt":77,"zipAvailable":78},[68,71,74],{"tool":69,"command":70},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill speak-performance-tuning",{"tool":72,"command":73},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill speak-performance-tuning",{"tool":75,"command":76},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill speak-performance-tuning","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fspeak-pack\u002Fskills\u002Fspeak-performance-tuning\u002FSKILL.md",true,[],[81,113,149,172,198,225],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":86,"sourceHtmlUrl":87,"categories":88,"keywords":92,"publishedAt":112},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[89],{"categoryNo":90,"categoryName":91,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",[93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","with","you","fonts","2026-11-11 15:11:14",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":123,"publishedAt":48},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[120],{"categoryNo":121,"categoryName":122,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",[124,125,99,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,104,142,143,144,145,146,147,148],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","use","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":153,"sourceHtmlUrl":154,"categories":155,"keywords":160,"publishedAt":48},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[156,159],{"categoryNo":157,"categoryName":158,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":121,"categoryName":122,"taxonomyType":21,"taxonomyTypeDesc":22},[161,162,163,128,164,165,125,166,97,167,138,168,169,170,171,109,146],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":176,"sourceHtmlUrl":177,"categories":178,"keywords":179,"publishedAt":48},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[180,181,182,183,184,185,186,187,141,188,189,190,191,192,193,194,109,195,196,197,146,30],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":199,"name":200,"nameZh":6,"description":201,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":202,"sourceHtmlUrl":203,"categories":204,"keywords":208,"publishedAt":48},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[205],{"categoryNo":206,"categoryName":207,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[209,210,211,212,213,214,215,216,217,218,219,220,221,222,109,146,223,30,224],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":226,"name":227,"nameZh":6,"description":228,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":229,"sourceHtmlUrl":230,"categories":231,"keywords":233,"publishedAt":48},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[232],{"categoryNo":206,"categoryName":207,"taxonomyType":21,"taxonomyTypeDesc":22},[227,234,235,236,237,238,239,167,240,241,141,242,243,244,245,146,246],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]