[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DFZE0B14WNAJ5D6FQV01DS":3,"skill-same:01M6DFZE0B14WNAJ5D6FQV01DS":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":27,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":13,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":49,"install":50,"resources":63},"01M6DFZE0B14WNAJ5D6FQV01DS","add-voice-transcription",null,"Add voice message transcription to NanoDex using OpenAI's Whisper API. Automatically transcribes WhatsApp voice notes so the agent can read and respond to them.","mbaker95\u002Fnanodex","mbaker95","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F11398294?v=4","01M6DFXVNAJHZG78Y2D700Y6V3","01M6DFXVTTW83QGKTJ9FJ5YCH5",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fadd-voice-transcription\u002FSKILL.md",[17,22],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[28,29,30,31,32,33,34,35,36,37,38],"voice","add voice","transcription","add voice transcription","whatsapp","notes","openai","api","read","whisper","message","2026-11-10 10:12:30",false,"---\nname: add-voice-transcription\ndescription: Add voice message transcription to NanoDex using OpenAI's Whisper API. Automatically transcribes WhatsApp voice notes so the agent can read and respond to them.\n---\n\n# Add Voice Transcription\n\nThis skill adds automatic voice message transcription to NanoDex's WhatsApp channel using OpenAI's Whisper API. When a voice note arrives, it is downloaded, transcribed, and delivered to the agent as `[Voice: \u003Ctranscript>]`.\n\n## Phase 1: Pre-flight\n\n### Check if already applied\n\nCheck if `src\u002Ftranscription.ts` exists. If it does, skip to Phase 3 (Configure). The code changes are already in place.\n\n### Ask the user\n\nAsk the user directly: do they have an OpenAI API key for Whisper transcription?\n\nIf yes, collect it now. If no, direct them to create one at https:\u002F\u002Fplatform.openai.com\u002Fapi-keys.\n\n## Phase 2: Apply Code Changes\n\n**Prerequisite:** The bundled WhatsApp channel must already be configured. This skill modifies WhatsApp channel files.\n\n### Ensure WhatsApp fork remote\n\n```bash\ngit remote -v\n```\n\nIf `whatsapp` is missing, add it:\n\n```bash\ngit remote add whatsapp https:\u002F\u002Fgithub.com\u002Fqwibitai\u002Fnanoclaw-whatsapp.git\n```\n\n### Merge the skill branch\n\n```bash\ngit fetch whatsapp skill\u002Fvoice-transcription\ngit merge whatsapp\u002Fskill\u002Fvoice-transcription\n```\n\nThis merges in:\n- `src\u002Ftranscription.ts` (voice transcription module using OpenAI Whisper)\n- Voice handling in `src\u002Fchannels\u002Fwhatsapp.ts` (isVoiceMessage check, transcribeAudioMessage call)\n- Transcription tests in `src\u002Fchannels\u002Fwhatsapp.test.ts`\n- `openai` npm dependency in `package.json`\n- `OPENAI_API_KEY` in `.env.example`\n\nIf the merge reports conflicts, resolve them by reading the conflicted files and understanding the intent of both sides.\n\n### Validate code changes\n\n```bash\nnpm install --legacy-peer-deps\nnpm run build\nnpx vitest run src\u002Fchannels\u002Fwhatsapp.test.ts\n```\n\nAll tests must pass and build must be clean before proceeding.\n\n## Phase 3: Configure\n\n### Get OpenAI API key (if needed)\n\nIf the user doesn't have an API key:\n\n> I need you to create an OpenAI API key:\n>\n> 1. Go to https:\u002F\u002Fplatform.openai.com\u002Fapi-keys\n> 2. Click \"Create new secret key\"\n> 3. Give it a name (e.g., \"NanoDex Transcription\")\n> 4. Copy the key (starts with `sk-`)\n>\n> Cost: ~$0.006 per minute of audio (~$0.003 per typical 30-second voice note)\n\nWait for the user to provide the key.\n\n### Add to environment\n\nAdd to `.env`:\n\n```bash\nOPENAI_API_KEY=\u003Ctheir-key>\n```\n\nSync to container environment:\n\n```bash\nmkdir -p data\u002Fenv && cp .env data\u002Fenv\u002Fenv\n```\n\nThe container reads environment from `data\u002Fenv\u002Fenv`, not `.env` directly.\n\n### Build and restart\n\n```bash\nnpm run build\nlaunchctl kickstart -k gui\u002F$(id -u)\u002Fcom.nanodex  # macOS\n# Linux: systemctl --user restart nanodex\n```\n\n## Phase 4: Verify\n\n### Test with a voice note\n\nTell the user:\n\n> Send a voice note in any registered WhatsApp chat. The agent should receive it as `[Voice: \u003Ctranscript>]` and respond to its content.\n\n### Check logs if needed\n\n```bash\ntail -f logs\u002Fnanodex.log | grep -i voice\n```\n\nLook for:\n- `Transcribed voice message` — successful transcription with character count\n- `OPENAI_API_KEY not set` — key missing from `.env`\n- `OpenAI transcription failed` — API error (check key validity, billing)\n- `Failed to download audio message` — media download issue\n\n## Troubleshooting\n\n### Voice notes show \"[Voice Message - transcription unavailable]\"\n\n1. Check `OPENAI_API_KEY` is set in `.env` AND synced to `data\u002Fenv\u002Fenv`\n2. Verify key works: `curl -s https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fmodels -H \"Authorization: Bearer $OPENAI_API_KEY\" | head -c 200`\n3. Check OpenAI billing — Whisper requires a funded account\n\n### Voice notes show \"[Voice Message - transcription failed]\"\n\nCheck logs for the specific error. Common causes:\n- Network timeout — transient, will work on next message\n- Invalid API key — regenerate at https:\u002F\u002Fplatform.openai.com\u002Fapi-keys\n- Rate limiting — wait and retry\n\n### Agent doesn't respond to voice notes\n\nVerify the chat is registered and the agent is running. Voice transcription only runs for registered groups.\n","# Add Voice Transcription\n\nThis skill adds automatic voice message transcription to NanoDex's WhatsApp channel using OpenAI's Whisper API. When a voice note arrives, it is downloaded, transcribed, and delivered to the agent as `[Voice: \u003Ctranscript>]`.\n\n## Phase 1: Pre-flight\n\n### Check if already applied\n\nCheck if `src\u002Ftranscription.ts` exists. If it does, skip to Phase 3 (Configure). The code changes are already in place.\n\n### Ask the user\n\nAsk the user directly: do they have an OpenAI API key for Whisper transcription?\n\nIf yes, collect it now. If no, direct them to create one at https:\u002F\u002Fplatform.openai.com\u002Fapi-keys.\n\n## Phase 2: Apply Code Changes\n\n**Prerequisite:** The bundled WhatsApp channel must already be configured. This skill modifies WhatsApp channel files.\n\n### Ensure WhatsApp fork remote\n\n```bash\ngit remote -v\n```\n\nIf `whatsapp` is missing, add it:\n\n```bash\ngit remote add whatsapp https:\u002F\u002Fgithub.com\u002Fqwibitai\u002Fnanoclaw-whatsapp.git\n```\n\n### Merge the skill branch\n\n```bash\ngit fetch whatsapp skill\u002Fvoice-transcription\ngit merge whatsapp\u002Fskill\u002Fvoice-transcription\n```\n\nThis merges in:\n- `src\u002Ftranscription.ts` (voice transcription module using OpenAI Whisper)\n- Voice handling in `src\u002Fchannels\u002Fwhatsapp.ts` (isVoiceMessage check, transcribeAudioMessage call)\n- Transcription tests in `src\u002Fchannels\u002Fwhatsapp.test.ts`\n- `openai` npm dependency in `package.json`\n- `OPENAI_API_KEY` in `.env.example`\n\nIf the merge reports conflicts, resolve them by reading the conflicted files and understanding the intent of both sides.\n\n### Validate code changes\n\n```bash\nnpm install --legacy-peer-deps\nnpm run build\nnpx vitest run src\u002Fchannels\u002Fwhatsapp.test.ts\n```\n\nAll tests must pass and build must be clean before proceeding.\n\n## Phase 3: Configure\n\n### Get OpenAI API key (if needed)\n\nIf the user doesn't have an API key:\n\n> I need you to create an OpenAI API key:\n>\n> 1. Go to https:\u002F\u002Fplatform.openai.com\u002Fapi-keys\n> 2. Click \"Create new secret key\"\n> 3. Give it a name (e.g., \"NanoDex Transcription\")\n> 4. Copy the key (starts with `sk-`)\n>\n> Cost: ~$0.006 per minute of audio (~$0.003 per typical 30-second voice note)\n\nWait for the user to provide the key.\n\n### Add to environment\n\nAdd to `.env`:\n\n```bash\nOPENAI_API_KEY=\u003Ctheir-key>\n```\n\nSync to container environment:\n\n```bash\nmkdir -p data\u002Fenv && cp .env data\u002Fenv\u002Fenv\n```\n\nThe container reads environment from `data\u002Fenv\u002Fenv`, not `.env` directly.\n\n### Build and restart\n\n```bash\nnpm run build\nlaunchctl kickstart -k gui\u002F$(id -u)\u002Fcom.nanodex  # macOS\n# Linux: systemctl --user restart nanodex\n```\n\n## Phase 4: Verify\n\n### Test with a voice note\n\nTell the user:\n\n> Send a voice note in any registered WhatsApp chat. The agent should receive it as `[Voice: \u003Ctranscript>]` and respond to its content.\n\n### Check logs if needed\n\n```bash\ntail -f logs\u002Fnanodex.log | grep -i voice\n```\n\nLook for:\n- `Transcribed voice message` — successful transcription with character count\n- `OPENAI_API_KEY not set` — key missing from `.env`\n- `OpenAI transcription failed` — API error (check key validity, billing)\n- `Failed to download audio message` — media download issue\n\n## Troubleshooting\n\n### Voice notes show \"[Voice Message - transcription unavailable]\"\n\n1. Check `OPENAI_API_KEY` is set in `.env` AND synced to `data\u002Fenv\u002Fenv`\n2. Verify key works: `curl -s https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fmodels -H \"Authorization: Bearer $OPENAI_API_KEY\" | head -c 200`\n3. Check OpenAI billing — Whisper requires a funded account\n\n### Voice notes show \"[Voice Message - transcription failed]\"\n\nCheck logs for the specific error. Common causes:\n- Network timeout — transient, will work on next message\n- Invalid API key — regenerate at https:\u002F\u002Fplatform.openai.com\u002Fapi-keys\n- Rate limiting — wait and retry\n\n### Agent doesn't respond to voice notes\n\nVerify the chat is registered and the agent is running. Voice transcription only runs for registered groups.\n",{"name":5,"description":7},"main","b6b2f4d4a0c7243409d1684119a6772629bfeba6",".agents\u002Fskills\u002Fadd-voice-transcription","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex","https:\u002F\u002Fgithub.com\u002Fmbaker95","2026-03-12 23:02:12",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add mbaker95\u002Fnanodex --skill add-voice-transcription",{"tool":56,"command":57},"bunx","bunx skills add mbaker95\u002Fnanodex --skill add-voice-transcription",{"tool":59,"command":60},"pnpm","pnpm dlx skills add mbaker95\u002Fnanodex --skill add-voice-transcription","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fadd-voice-transcription\u002FSKILL.md",true,[64],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fyoutube_search_api.py","SCRIPT","脚本",3992,"https:\u002F\u002Fgithub.com\u002Fstrmt7\u002Fai_skills_collection_benchmarked\u002Fblob\u002Fmain\u002Fincluded\u002Fskills\u002Fby-category\u002Fdevops-cloud-operations\u002Fbrowser-automation-reference\u002Fyoutube-search-api-skill\u002Fscripts\u002Fyoutube_search_api.py",[71,97,116,133,145,157],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":78,"publishedAt":39},"01M6DG2XYNH5XV7XGTJJ1SF0TG","agent-browser","Browse the web for any task — research topics, read articles, interact with web apps, fill forms, take screenshots, extract data, and test web pages. Use whenever a browser would be useful, not just when the user explicitly asks.","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002Fcontainer\u002Fskills\u002Fagent-browser\u002FSKILL.md",[77],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[79,80,81,82,83,84,85,86,87,88,89,36,90,91,92,93,94,95,96],"agent browser","browser","pages","forms","task","test web","take","use","extract","data","user","screenshots","research","test","web","just","Bash","browse",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":106,"publishedAt":39},"01M6DG2TPZAT3SMWSYFJ3K82TE","x-integration","X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on \"setup x\", \"x integration\", \"twitter\", \"post tweet\", \"tweet\".","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fx-integration\u002FSKILL.md",[103],{"categoryNo":104,"categoryName":105,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",[107,108,86,109,110,111,112,113,114,115],"x integration","integration","testing","setup","troubleshooting","twitter","reply","quote","triggers",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":39},"01M6DG2Q4BJQ046BZSR9N7GZ72","use-local-whisper","Use when the user wants local voice transcription instead of OpenAI Whisper API. Switches to whisper.cpp running on Apple Silicon. WhatsApp only for now. Requires voice-transcription skill to be applied first.","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fuse-local-whisper\u002FSKILL.md",[],[37,123,86,124,125,126,127,128,89,28,129,35,130,34,131,30,132,32],"local whisper","local","use local whisper","apple","openai whisper","only","apple silicon","first","cpp","openai whisper api",{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":139,"publishedAt":39},"01M6DG2N2Z1V8VV4MQFRKFAQV0","update-skills","Check for and apply updates to installed skill branches from upstream.","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fupdate-skills\u002FSKILL.md",[],[140,141,142,143,144],"update","update skills","upstream","branches","check",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":39},"01M6DG2J5D7Y3R2BF8V87XZAXF","update-nanoclaw","Efficiently bring upstream NanoClaw updates into a customized install, with preview, selective cherry-pick, and low token usage.","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fupdate-nanoclaw\u002FSKILL.md",[],[140,152,153,154,142,155,156],"update nanoclaw","install","pick","token","preview",{"skillNo":158,"name":110,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":39},"01M6DG2FN7S7DVD337CNT5Y67D","Run initial NanoClaw setup. Use when user wants to install dependencies, authenticate messaging channels, register their main channel, or start the background services. Triggers on \"setup\", \"install\", \"configure nanoclaw\", or first-time setup requests.","https:\u002F\u002Fgithub.com\u002Fmbaker95\u002Fnanodex\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsetup\u002FSKILL.md",[],[110,153,115,163,164,44,86,165,89,166,130,167,168,169,170],"time","dependencies","channel","configure","services","start","messaging","run"]