@bohuyeshan/openagent-labforge-core 3.11.0

package/generated/skills-bundles/full/skills/productivity/issue-tracking/openai-curated__linear/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: "openai-curated/linear"
+description: "Manage issues, projects & team workflows in Linear. Use when the user wants to read, create or updates tickets in Linear."
+metadata:
+  short-description: "Manage Linear issues in Codex"
+  category: "productivity/issue-tracking"
+---
+
+# Linear
+
+## Overview
+
+This skill provides a structured workflow for managing issues, projects & team workflows in Linear. It ensures consistent integration with the Linear MCP server, which offers natural-language project management for issues, projects, documentation, and team collaboration.
+
+## Prerequisites
+- Linear MCP server must be connected and accessible via OAuth
+- Confirm access to the relevant Linear workspace, teams, and projects
+
+## Required Workflow
+
+**Follow these steps in order. Do not skip steps.**
+
+### Step 0: Set up Linear MCP (if not already configured)
+
+If any MCP call fails because Linear MCP is not connected, pause and set it up:
+
+1. Add the Linear MCP:
+   - `codex mcp add linear --url https://mcp.linear.app/mcp`
+2. Enable remote MCP client:
+   - Set `[features] rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client`
+3. Log in with OAuth:
+   - `codex mcp login linear`
+
+After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.
+
+**Windows/WSL note:** If you see connection errors on Windows, try configuring the Linear MCP to run via WSL:
+```json
+{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
+```
+
+### Step 1
+Clarify the user's goal and scope (e.g., issue triage, sprint planning, documentation audit, workload balance). Confirm team/project, priority, labels, cycle, and due dates as needed.
+
+### Step 2
+Select the appropriate workflow (see Practical Workflows below) and identify the Linear MCP tools you will need. Confirm required identifiers (issue ID, project ID, team key) before calling tools.
+
+### Step 3
+Execute Linear MCP tool calls in logical batches:
+- Read first (list/get/search) to build context.
+- Create or update next (issues, projects, labels, comments) with all required fields.
+- For bulk operations, explain the grouping logic before applying changes.
+
+### Step 4
+Summarize results, call out remaining gaps or blockers, and propose next actions (additional issues, label changes, assignments, or follow-up comments).
+
+## Available Tools
+
+Issue Management: `list_issues`, `get_issue`, `create_issue`, `update_issue`, `list_my_issues`, `list_issue_statuses`, `list_issue_labels`, `create_issue_label`
+
+Project & Team: `list_projects`, `get_project`, `create_project`, `update_project`, `list_teams`, `get_team`, `list_users`
+
+Documentation & Collaboration: `list_documents`, `get_document`, `search_documentation`, `list_comments`, `create_comment`, `list_cycles`
+
+## Practical Workflows
+
+- Sprint Planning: Review open issues for a target team, pick top items by priority, and create a new cycle (e.g., "Q1 Performance Sprint") with assignments.
+- Bug Triage: List critical/high-priority bugs, rank by user impact, and move the top items to "In Progress."
+- Documentation Audit: Search documentation (e.g., API auth), then open labeled "documentation" issues for gaps or outdated sections with detailed fixes.
+- Team Workload Balance: Group active issues by assignee, flag anyone with high load, and suggest or apply redistributions.
+- Release Planning: Create a project (e.g., "v2.0 Release") with milestones (feature freeze, beta, docs, launch) and generate issues with estimates.
+- Cross-Project Dependencies: Find all "blocked" issues, identify blockers, and create linked issues if missing.
+- Automated Status Updates: Find your issues with stale updates and add status comments based on current state/blockers.
+- Smart Labeling: Analyze unlabeled issues, suggest/apply labels, and create missing label categories.
+- Sprint Retrospectives: Generate a report for the last completed cycle, note completed vs. pushed work, and open discussion issues for patterns.
+
+## Tips for Maximum Productivity
+
+- Batch operations for related changes; consider smart templates for recurring issue structures.
+- Use natural queries when possible ("Show me what John is working on this week").
+- Leverage context: reference prior issues in new requests.
+- Break large updates into smaller batches to avoid rate limits; cache or reuse filters when listing frequently.
+
+## Troubleshooting
+
+- Authentication: Clear browser cookies, re-run OAuth, verify workspace permissions, ensure API access is enabled.
+- Tool Calling Errors: Confirm the model supports multiple tool calls, provide all required fields, and split complex requests.
+- Missing Data: Refresh token, verify workspace access, check for archived projects, and confirm correct team selection.
+- Performance: Remember Linear API rate limits; batch bulk operations, use specific filters, or cache frequent queries.

package/generated/skills-bundles/full/skills/productivity/issue-tracking/openai-curated__linear/agents/openai.yaml

@@ -0,0 +1,14 @@
+interface:
+  display_name: "Linear"
+  short_description: "Manage Linear issues in Codex"
+  icon_small: "./assets/linear-small.svg"
+  icon_large: "./assets/linear.png"
+  default_prompt: "Use Linear context to triage or update relevant issues for this task, with clear next actions."
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "linear"
+      description: "Linear MCP server"
+      transport: "streamable_http"
+      url: "https://mcp.linear.app/mcp"

package/generated/skills-bundles/full/skills/productivity/issue-tracking/openai-curated__linear/assets/linear-small.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="200" height="200" viewBox="0 0 100 100">
+  <path
+    d="M1.22541 61.5228c-.2225-.9485.90748-1.5459 1.59638-.857L39.3342 97.1782c.6889.6889.0915 1.8189-.857 1.5964C20.0515 94.4522 5.54779 79.9485 1.22541 61.5228ZM.00189135 46.8891c-.01764375.2833.08887215.5599.28957165.7606L52.3503 99.7085c.2007.2007.4773.3075.7606.2896 2.3692-.1476 4.6938-.46 6.9624-.9259.7645-.157 1.0301-1.0963.4782-1.6481L2.57595 39.4485c-.55186-.5519-1.49117-.2863-1.648174.4782-.465915 2.2686-.77832 4.5932-.92588465 6.9624ZM4.21093 29.7054c-.16649.3738-.08169.8106.20765 1.1l64.77602 64.776c.2894.2894.7262.3742 1.1.2077 1.7861-.7956 3.5171-1.6927 5.1855-2.684.5521-.328.6373-1.0867.1832-1.5407L8.43566 24.3367c-.45409-.4541-1.21271-.3689-1.54074.1832-.99132 1.6684-1.88843 3.3994-2.68399 5.1855ZM12.6587 18.074c-.3701-.3701-.393-.9637-.0443-1.3541C21.7795 6.45931 35.1114 0 49.9519 0 77.5927 0 100 22.4073 100 50.0481c0 14.8405-6.4593 28.1724-16.7199 37.3375-.3903.3487-.984.3258-1.3542-.0443L12.6587 18.074Z"
+  />
+</svg>

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M Asif Rahman (https://github.com/Asif2BD)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/README.md

@@ -0,0 +1,127 @@
+# 🎙️ VoiceClaw — Local Voice I/O for OpenClaw Agents
+
+**ClawHub:** [clawhub.ai/Asif2BD/voiceclaw](https://clawhub.ai/Asif2BD/voiceclaw) · **GitHub:** [github.com/Asif2BD/VoiceClaw](https://github.com/Asif2BD/VoiceClaw)
+
+> Created by **[M Asif Rahman](https://github.com/Asif2BD)** — Founder of [MissionDeck.ai](https://missiondeck.ai) · [xCloud](https://xcloud.host) · [WPDevelopers](https://github.com/WPDevelopers)
+
+A local-only voice skill for [OpenClaw](https://openclaw.ai) agents. Transcribe inbound voice messages with **Whisper** and reply with synthesized speech via **Piper TTS** — no cloud, no API keys, no paid services.
+
+---
+
+## Install
+
+**Option 1 — Via ClawHub** *(if ClawHub is installed)*
+```bash
+clawhub install voiceclaw
+```
+
+**Option 2 — Via Git** *(no ClawHub needed)*
+```bash
+git clone https://github.com/Asif2BD/VoiceClaw.git ~/.openclaw/custom-skills/voiceclaw
+```
+
+**Option 3 — Download release** *(manual, no tools needed)*
+```bash
+curl -L https://github.com/Asif2BD/VoiceClaw/releases/latest/download/voiceclaw.skill -o voiceclaw.skill
+unzip voiceclaw.skill -d ~/.openclaw/custom-skills/voiceclaw
+```
+
+> After any install method, restart OpenClaw for the skill to be detected.
+
+---
+
+## Requirements
+
+- `whisper` — whisper.cpp binary ([install guide](https://github.com/ggerganov/whisper.cpp))
+- Whisper model: `ggml-base.en.bin` — auto-downloaded on first use, or manually:
+  ```bash
+  # One-time setup only — not run by the skill scripts
+  mkdir -p ~/.cache/whisper
+  curl -L -o ~/.cache/whisper/ggml-base.en.bin \
+    https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin
+  ```
+  > Set `WHISPER_MODEL=/path/to/ggml-base.en.bin` if your model is stored elsewhere.
+- `piper` — TTS binary + `.onnx` voice models ([install guide](https://github.com/rhasspy/piper)). Set `VOICECLAW_VOICES_DIR=/path/to/voices/` to point to your voice models (default: `~/.local/share/piper/voices/`)
+- `ffmpeg` — for audio format conversion
+
+---
+
+## What it does
+
+- **Speech-to-Text**: Inbound voice/audio (OGG, MP3, WAV, M4A) → transcript text via Whisper.cpp
+- **Text-to-Speech**: Agent text replies → voice audio via Piper TTS (7 English voices)
+- **Agent behavior**: When a voice message arrives, the agent automatically responds with both voice + text
+- **100% local**: No data sent anywhere — all inference runs on your server
+
+---
+
+## How it works
+
+```
+Inbound voice message (OGG/MP3/WAV)
+        ↓
+  ffmpeg → 16kHz mono WAV
+        ↓
+  whisper.cpp → transcript text
+        ↓
+  Agent reads transcript, composes reply
+        ↓
+  Piper TTS → WAV → OGG Opus
+        ↓
+  Voice reply + text transcript sent together
+```
+
+---
+
+## Usage
+
+```bash
+# Transcribe a voice message
+bash scripts/transcribe.sh /path/to/voice.ogg
+
+# Generate a voice reply (returns path to WAV)
+bash scripts/speak.sh "Your task is complete." /tmp/reply.wav
+
+# Convert WAV → OGG Opus for Telegram
+ffmpeg -i /tmp/reply.wav -c:a libopus -b:a 32k /tmp/reply.ogg -y
+```
+
+---
+
+## Available Voices
+
+| Voice ID | Style |
+|---|---|
+| `en_US-lessac-medium` | Neutral American (default) |
+| `en_US-amy-medium` | Warm American female |
+| `en_US-joe-medium` | American male |
+| `en_US-kusal-medium` | Expressive American male |
+| `en_US-danny-low` | Deep American male (fast) |
+| `en_GB-alba-medium` | British female |
+| `en_GB-northern_english_male-medium` | Northern British male |
+
+Voice models live at `/opt/piper/voices/`. See `SKILL.md` for full agent integration instructions.
+
+---
+
+## Security
+
+- **All processing is local** — no audio or text is sent to any cloud service or external API
+- **Temp files are cleaned up** — audio is converted in `/tmp` and deleted immediately after transcription (bash `trap` on EXIT)
+- **Voice names are sanitized** — input stripped to `[a-zA-Z0-9_-]` only, preventing path traversal
+- **No network calls** — neither script makes any network request
+
+---
+
+## Author
+
+**[M Asif Rahman](https://github.com/Asif2BD)**
+- 🌐 [asif.im](https://asif.im)
+- 🐙 [github.com/Asif2BD](https://github.com/Asif2BD)
+- 🔑 [clawhub.ai/Asif2BD](https://clawhub.ai/Asif2BD)
+
+---
+
+## License
+
+MIT © 2026 [M Asif Rahman](https://github.com/Asif2BD)

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/SECURITY.md

@@ -0,0 +1,68 @@
+# Security Policy
+
+## Overview
+
+VoiceClaw is a **local-only** voice I/O skill. The operational scripts (`transcribe.sh`, `speak.sh`) make **zero network requests** and send **no data to any external service**.
+
+> The only network activity in this project is a **one-time optional setup step** (downloading the Whisper model from HuggingFace). This is not performed by the skill scripts — it is a manual prerequisite documented in SKILL.md.
+
+---
+
+## Design Principles
+
+| Property | Detail |
+|---|---|
+| **Local-only inference** | All STT (Whisper) and TTS (Piper) runs on-device using pre-installed binaries |
+| **Zero network calls during operation** | `transcribe.sh` and `speak.sh` make no HTTP requests whatsoever |
+| **No cloud APIs** | No API keys, no external endpoints, no telemetry |
+| **No credential handling** | Scripts accept no passwords, tokens, or secrets |
+| **No eval/exec of untrusted input** | Text is piped to Piper via stdin, never shell-evaluated |
+| **Input sanitization** | Voice name parameter sanitized to `[a-zA-Z0-9_-]` — prevents path traversal |
+| **Temporary file cleanup** | WAV files written to `/tmp` are deleted via bash `trap` on script exit |
+| **File existence checks** | All input files and model files verified before use |
+| **Configurable paths** | No hardcoded system paths — all paths use env vars with safe defaults |
+
+---
+
+## Binary Requirements (Declared)
+
+| Binary | Source | Network during operation |
+|---|---|---|
+| `whisper` (whisper.cpp) | Pre-installed local binary | ❌ None |
+| `piper` | Pre-installed local binary (`pip install piper-tts`) | ❌ None |
+| `ffmpeg` | System package (`apt install ffmpeg`) | ❌ None |
+
+### Model Files
+
+| File | Source | Network during operation |
+|---|---|---|
+| `ggml-base.en.bin` | Downloaded once at setup (HuggingFace) | ❌ None — static read-only file |
+| `*.onnx` voice models | Pre-installed at `$VOICECLAW_VOICES_DIR` | ❌ None — static read-only files |
+
+**Path configuration:**
+- Whisper model: `$WHISPER_MODEL` (defaults to `$HOME/.cache/whisper/ggml-base.en.bin`)
+- Piper voices: `$VOICECLAW_VOICES_DIR` (defaults to `$HOME/.local/share/piper/voices/`)
+- No paths are hardcoded to any specific user or system directory.
+
+---
+
+## Threat Model
+
+### Protected against
+
+- **Path traversal** — voice name input is stripped to `[a-zA-Z0-9_-]`; any `../` or absolute path attempt results in an empty string, which fails the model existence check and exits cleanly
+- **Temp file leakage** — `/tmp` WAV files deleted on script EXIT via `trap cleanup EXIT`, even on error
+- **Shell injection** — TTS text is passed via stdin to Piper, not interpolated into a shell command
+
+### Out of scope
+
+- Adversarial audio content (e.g., prompt injection via voice) — model-level concern, not script-level
+- Host system security (firewall, user permissions) — OpenClaw deployment concern
+
+---
+
+## Reporting a Vulnerability
+
+Open an issue on [GitHub](https://github.com/Asif2BD/VoiceClaw/issues) or contact **M Asif Rahman** directly at [asif.im](https://asif.im).
+
+Please do not disclose security vulnerabilities publicly before they are addressed.

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: "skills-main/voiceclaw"
+description: "Local voice I/O for OpenClaw agents. Transcribe inbound audio/voice messages using local Whisper (whisper.cpp) and generate voice replies using local Piper TTS. Requires whisper, piper, and ffmpeg pre-installed on the system. All inference runs on-device — no network calls, no cloud APIs, no API keys. Use when an agent receives a voice/audio message and should respond in both voice and text, or when any text response should be synthesized and sent as audio. Triggers on: voice messages, audio attachments, respond in voice, send as audio, speak this, voiceclaw."
+metadata:
+  openclaw: {"requires":{"bins":["whisper","piper","ffmpeg"]},"network":"none","env":[{"name":"WHISPER_BIN","description":"Path to whisper binary (default: auto-detected via which)"},{"name":"WHISPER_MODEL","description":"Path to ggml-base.en.bin model file (default: ~/.cache/whisper/ggml-base.en.bin)"},{"name":"PIPER_BIN","description":"Path to piper binary (default: auto-detected via which)"},{"name":"VOICECLAW_VOICES_DIR","description":"Path to directory containing .onnx voice model files (default: ~/.local/share/piper/voices)"}]}
+  category: "productivity/voice-and-accessibility"
+---
+# VoiceClaw
+
+Local-only voice I/O for OpenClaw agents.
+
+- **STT:** `transcribe.sh` — converts audio to text via local Whisper binary
+- **TTS:** `speak.sh` — converts text to speech via local Piper binary
+- **Network calls: none** — both scripts run fully offline
+- **No cloud APIs, no API keys required**
+
+---
+
+## Prerequisites
+
+The following must be installed on the system before using this skill:
+
+| Requirement | Purpose |
+|---|---|
+| `whisper` binary | Speech-to-text inference |
+| `ggml-base.en.bin` model file | Whisper STT model |
+| `piper` binary | Text-to-speech synthesis |
+| `*.onnx` voice model files | Piper TTS voices |
+| `ffmpeg` | Audio format conversion |
+
+See **README.md** for installation and setup instructions.
+
+---
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `WHISPER_BIN` | auto-detected via `which` | Path to whisper binary |
+| `WHISPER_MODEL` | `~/.cache/whisper/ggml-base.en.bin` | Path to Whisper model file |
+| `PIPER_BIN` | auto-detected via `which` | Path to piper binary |
+| `VOICECLAW_VOICES_DIR` | `~/.local/share/piper/voices` | Directory containing `.onnx` voice model files |
+
+---
+
+## Verify Setup
+
+```bash
+which whisper && echo "STT binary: OK"
+which piper   && echo "TTS binary: OK"
+which ffmpeg  && echo "ffmpeg: OK"
+ls "${WHISPER_MODEL:-$HOME/.cache/whisper/ggml-base.en.bin}" && echo "STT model: OK"
+ls "${VOICECLAW_VOICES_DIR:-$HOME/.local/share/piper/voices}"/*.onnx 2>/dev/null | head -1 && echo "TTS voices: OK"
+```
+
+---
+
+## Inbound Voice: Transcribe
+
+```bash
+# Transcribe audio → text (supports ogg, mp3, m4a, wav, flac)
+TRANSCRIPT=$(bash scripts/transcribe.sh /path/to/audio.ogg)
+```
+
+Override model path:
+```bash
+WHISPER_MODEL=/path/to/ggml-base.en.bin bash scripts/transcribe.sh audio.ogg
+```
+
+---
+
+## Outbound Voice: Speak
+
+```bash
+# Step 1: Generate WAV (local Piper — no network)
+WAV=$(bash scripts/speak.sh "Your response here." /tmp/reply.wav en_US-lessac-medium)
+
+# Step 2: Convert to OGG Opus (Telegram voice requirement)
+ffmpeg -i "$WAV" -c:a libopus -b:a 32k /tmp/reply.ogg -y -loglevel error
+
+# Step 3: Send via message tool (filePath=/tmp/reply.ogg)
+```
+
+Override voice directory:
+```bash
+VOICECLAW_VOICES_DIR=/path/to/voices bash scripts/speak.sh "Hello." /tmp/reply.wav
+```
+
+---
+
+## Available Voices
+
+| Voice | Style |
+|---|---|
+| `en_US-lessac-medium` | Neutral American (default) |
+| `en_US-amy-medium` | Warm American female |
+| `en_US-joe-medium` | American male |
+| `en_US-kusal-medium` | Expressive American male |
+| `en_US-danny-low` | Deep American male (fast) |
+| `en_GB-alba-medium` | British female |
+| `en_GB-northern_english_male-medium` | Northern British male |
+
+---
+
+## Agent Behavior Rules
+
+1. **Voice in → Voice + Text out.** Always respond with both a voice reply and a text reply when a voice message is received.
+2. **Include the transcript.** Show *"🎙️ I heard: [transcript]"* at the top of every text reply to a voice message.
+3. **Keep voice responses concise.** Piper TTS works best under ~200 words — summarize for audio, include full detail in text.
+4. **Local only.** Never use a cloud TTS/STT API. Only the local `whisper` and `piper` binaries.
+5. **Send voice before text.** Send the audio file first, then follow with the text reply.
+
+---
+
+## Full Example
+
+```bash
+# 1. Transcribe inbound voice message
+TRANSCRIPT=$(bash path/to/voiceclaw/scripts/transcribe.sh /path/to/voice.ogg)
+
+# 2. Compose reply and generate audio
+RESPONSE="Deployment complete. All checks passed."
+WAV=$(bash path/to/voiceclaw/scripts/speak.sh "$RESPONSE" /tmp/reply_$$.wav)
+ffmpeg -i "$WAV" -c:a libopus -b:a 32k /tmp/reply_$$.ogg -y -loglevel error
+
+# 3. Send voice + text
+# message(action=send, filePath=/tmp/reply_$$.ogg, ...)
+# reply: "🎙️ I heard: $TRANSCRIPT\n\n$RESPONSE"
+```
+
+---
+
+## Troubleshooting
+
+| Issue | Fix |
+|---|---|
+| `whisper: command not found` | Ensure whisper binary is installed and in PATH |
+| Whisper model not found | Set `WHISPER_MODEL=/path/to/ggml-base.en.bin` |
+| `piper: command not found` | Ensure piper binary is installed and in PATH |
+| Voice model missing | Set `VOICECLAW_VOICES_DIR=/path/to/voices/` |
+| OGG won't play on Telegram | Ensure `-c:a libopus` flag in ffmpeg command |

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/_meta.json

@@ -0,0 +1,11 @@
+{
+  "owner": "asif2bd",
+  "slug": "voiceclaw",
+  "displayName": "VoiceClaw",
+  "latest": {
+    "version": "1.0.6",
+    "publishedAt": 1772203550157,
+    "commit": "https://github.com/openclaw/skills/commit/d9fd3726c478264910b49beed20658e6ba57e263"
+  },
+  "history": []
+}

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/scripts/speak.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# speak.sh — Convert text to speech using local Piper TTS
+# Usage: speak.sh "text to speak" [output_file.wav] [voice]
+# Output: writes WAV to output_file, prints output path to stdout
+# Available voices: en_US-amy-medium, en_US-joe-medium, en_US-lessac-medium,
+#                   en_US-kusal-medium, en_US-danny-low,
+#                   en_GB-alba-medium, en_GB-northern_english_male-medium
+#
+# Environment variables:
+#   PIPER_BIN           — path to piper binary (default: auto-detected via `which`)
+#   VOICECLAW_VOICES_DIR — path to folder containing *.onnx voice models
+#                          (default: ~/.local/share/piper/voices)
+
+set -euo pipefail
+
+TEXT="${1:-}"
+OUTPUT="${2:-/tmp/voiceclaw_tts_$$.wav}"
+VOICE="${3:-en_US-lessac-medium}"
+VOICES_DIR="${VOICECLAW_VOICES_DIR:-$HOME/.local/share/piper/voices}"
+PIPER_BIN="${PIPER_BIN:-$(which piper 2>/dev/null || echo piper)}"
+
+if [[ -z "$TEXT" ]]; then
+  echo "Usage: speak.sh \"text\" [output.wav] [voice]" >&2
+  echo "  Env: PIPER_BIN, VOICECLAW_VOICES_DIR" >&2
+  exit 1
+fi
+
+# Sanitize voice name — allow only safe characters to prevent path traversal
+VOICE=$(echo "$VOICE" | tr -cd 'a-zA-Z0-9_-')
+if [[ -z "$VOICE" ]]; then
+  echo "Error: voice name is empty after sanitization" >&2
+  exit 1
+fi
+
+MODEL="$VOICES_DIR/$VOICE.onnx"
+CONFIG="$VOICES_DIR/$VOICE.onnx.json"
+
+if [[ ! -f "$MODEL" ]]; then
+  echo "Error: voice model not found: $MODEL" >&2
+  echo "Set VOICECLAW_VOICES_DIR=/path/to/voices/ or install piper voices." >&2
+  echo "Available voices in $VOICES_DIR:" >&2
+  ls "$VOICES_DIR"/*.onnx 2>/dev/null | xargs -n1 basename | sed 's/\.onnx$//' >&2 || echo "  (none found)" >&2
+  exit 1
+fi
+
+# Generate WAV — local piper binary, no network
+CONFIG_ARGS=()
+[[ -f "$CONFIG" ]] && CONFIG_ARGS=(-c "$CONFIG")
+
+echo "$TEXT" | "$PIPER_BIN" -m "$MODEL" "${CONFIG_ARGS[@]}" -f "$OUTPUT" 2>/dev/null
+
+echo "$OUTPUT"

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/scripts/transcribe.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# transcribe.sh — Convert audio to text using local Whisper (whisper.cpp)
+# Usage: transcribe.sh <audio_file> [model_path]
+# Output: prints transcript to stdout
+# Supports: ogg, mp3, m4a, wav, flac (auto-converts to wav via ffmpeg)
+#
+# Environment variables:
+#   WHISPER_BIN   — path to whisper binary (default: auto-detected via `which`)
+#   WHISPER_MODEL — path to ggml model file (default: ~/.cache/whisper/ggml-base.en.bin)
+
+set -euo pipefail
+
+AUDIO_FILE="${1:-}"
+MODEL="${2:-${WHISPER_MODEL:-$HOME/.cache/whisper/ggml-base.en.bin}}"
+WHISPER_BIN="${WHISPER_BIN:-$(which whisper 2>/dev/null || echo whisper)}"
+TMP_WAV="/tmp/voiceclaw_stt_$$.wav"
+
+if [[ -z "$AUDIO_FILE" ]]; then
+  echo "Usage: transcribe.sh <audio_file> [model_path]" >&2
+  echo "  Env: WHISPER_BIN, WHISPER_MODEL" >&2
+  exit 1
+fi
+
+if [[ ! -f "$AUDIO_FILE" ]]; then
+  echo "Error: file not found: $AUDIO_FILE" >&2
+  exit 1
+fi
+
+if [[ ! -f "$MODEL" ]]; then
+  echo "Error: Whisper model not found: $MODEL" >&2
+  echo "Set WHISPER_MODEL=/path/to/ggml-base.en.bin to point to your model." >&2
+  echo "See README.md for one-time model download instructions." >&2
+  exit 1
+fi
+
+cleanup() { rm -f "$TMP_WAV"; }
+trap cleanup EXIT
+
+# Convert to 16kHz mono WAV (Whisper requirement) — local ffmpeg, no network
+ffmpeg -i "$AUDIO_FILE" -ar 16000 -ac 1 "$TMP_WAV" -y -loglevel error
+
+# Transcribe — local whisper binary, no network
+"$WHISPER_BIN" -m "$MODEL" "$TMP_WAV" 2>/dev/null \
+  | grep -E '^\[' \
+  | sed 's/\[[0-9:. ->]*\]  *//' \
+  | tr '\n' ' ' \
+  | sed 's/^[[:space:]]*//' \
+  | sed 's/[[:space:]]*$//'
+
+echo  # final newline