cli-jaw 0.1.0

package/skills_ref/tmux/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: tmux
+description: Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
+metadata:
+  { "openclaw": { "emoji": "🧵", "os": ["darwin", "linux"], "requires": { "bins": ["tmux"] } } }
+---
+
+# tmux Session Control
+
+Control tmux sessions by sending keystrokes and reading output. Essential for managing Claude Code sessions.
+
+## When to Use
+
+✅ **USE this skill when:**
+
+- Monitoring Claude/Codex sessions in tmux
+- Sending input to interactive terminal applications
+- Scraping output from long-running processes in tmux
+- Navigating tmux panes/windows programmatically
+- Checking on background work in existing sessions
+
+## When NOT to Use
+
+❌ **DON'T use this skill when:**
+
+- Running one-off shell commands → use `exec` tool directly
+- Starting new background processes → use `exec` with `background:true`
+- Non-interactive scripts → use `exec` tool
+- The process isn't in tmux
+- You need to create a new tmux session → use `exec` with `tmux new-session`
+
+## Example Sessions
+
+| Session                 | Purpose                     |
+| ----------------------- | --------------------------- |
+| `shared`                | Primary interactive session |
+| `worker-2` - `worker-8` | Parallel worker sessions    |
+
+## Common Commands
+
+### List Sessions
+
+```bash
+tmux list-sessions
+tmux ls
+```
+
+### Capture Output
+
+```bash
+# Last 20 lines of pane
+tmux capture-pane -t shared -p | tail -20
+
+# Entire scrollback
+tmux capture-pane -t shared -p -S -
+
+# Specific pane in window
+tmux capture-pane -t shared:0.0 -p
+```
+
+### Send Keys
+
+```bash
+# Send text (doesn't press Enter)
+tmux send-keys -t shared "hello"
+
+# Send text + Enter
+tmux send-keys -t shared "y" Enter
+
+# Send special keys
+tmux send-keys -t shared Enter
+tmux send-keys -t shared Escape
+tmux send-keys -t shared C-c          # Ctrl+C
+tmux send-keys -t shared C-d          # Ctrl+D (EOF)
+tmux send-keys -t shared C-z          # Ctrl+Z (suspend)
+```
+
+### Window/Pane Navigation
+
+```bash
+# Select window
+tmux select-window -t shared:0
+
+# Select pane
+tmux select-pane -t shared:0.1
+
+# List windows
+tmux list-windows -t shared
+```
+
+### Session Management
+
+```bash
+# Create new session
+tmux new-session -d -s newsession
+
+# Kill session
+tmux kill-session -t sessionname
+
+# Rename session
+tmux rename-session -t old new
+```
+
+## Sending Input Safely
+
+For interactive TUIs (Claude Code, Codex, etc.), split text and Enter into separate sends to avoid paste/multiline edge cases:
+
+```bash
+tmux send-keys -t shared -l -- "Please apply the patch in src/foo.ts"
+sleep 0.1
+tmux send-keys -t shared Enter
+```
+
+## Claude Code Session Patterns
+
+### Check if Session Needs Input
+
+```bash
+# Look for prompts
+tmux capture-pane -t worker-3 -p | tail -10 | grep -E "❯|Yes.*No|proceed|permission"
+```
+
+### Approve Claude Code Prompt
+
+```bash
+# Send 'y' and Enter
+tmux send-keys -t worker-3 'y' Enter
+
+# Or select numbered option
+tmux send-keys -t worker-3 '2' Enter
+```
+
+### Check All Sessions Status
+
+```bash
+for s in shared worker-2 worker-3 worker-4 worker-5 worker-6 worker-7 worker-8; do
+  echo "=== $s ==="
+  tmux capture-pane -t $s -p 2>/dev/null | tail -5
+done
+```
+
+### Send Task to Session
+
+```bash
+tmux send-keys -t worker-4 "Fix the bug in auth.js" Enter
+```
+
+## Notes
+
+- Use `capture-pane -p` to print to stdout (essential for scripting)
+- `-S -` captures entire scrollback history
+- Target format: `session:window.pane` (e.g., `shared:0.0`)
+- Sessions persist across SSH disconnects

package/skills_ref/transcribe/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: "transcribe"
+description: "Transcribe audio files to text with optional diarization and known-speaker hints. Use when a user asks to transcribe speech from audio/video, extract text from recordings, or label speakers in interviews or meetings."
+---
+
+
+# Audio Transcribe
+
+Transcribe audio using OpenAI, with optional speaker diarization when requested. Prefer the bundled CLI for deterministic, repeatable runs.
+
+## Workflow
+1. Collect inputs: audio file path(s), desired response format (text/json/diarized_json), optional language hint, and any known speaker references.
+2. Verify `OPENAI_API_KEY` is set. If missing, ask the user to set it locally (do not ask them to paste the key).
+3. Run the bundled `transcribe_diarize.py` CLI with sensible defaults (fast text transcription).
+4. Validate the output: transcription quality, speaker labels, and segment boundaries; iterate with a single targeted change if needed.
+5. Save outputs under `output/transcribe/` when working in this repo.
+
+## Decision rules
+- Default to `gpt-4o-mini-transcribe` with `--response-format text` for fast transcription.
+- If the user wants speaker labels or diarization, use `--model gpt-4o-transcribe-diarize --response-format diarized_json`.
+- If audio is longer than ~30 seconds, keep `--chunking-strategy auto`.
+- Prompting is not supported for `gpt-4o-transcribe-diarize`.
+
+## Output conventions
+- Use `output/transcribe/<job-id>/` for evaluation runs.
+- Use `--out-dir` for multiple files to avoid overwriting.
+
+## Dependencies (install if missing)
+Prefer `uv` for dependency management.
+
+```
+uv pip install openai
+```
+If `uv` is unavailable:
+```
+python3 -m pip install openai
+```
+
+## Environment
+- `OPENAI_API_KEY` must be set for live API calls.
+- If the key is missing, instruct the user to create one in the OpenAI platform UI and export it in their shell.
+- Never ask the user to paste the full key in chat.
+
+## Skill path (set once)
+
+```bash
+export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+export TRANSCRIBE_CLI="$CODEX_HOME/skills/transcribe/scripts/transcribe_diarize.py"
+```
+
+User-scoped skills install under `$CODEX_HOME/skills` (default: `~/.codex/skills`).
+
+## CLI quick start
+Single file (fast text default):
+```
+python3 "$TRANSCRIBE_CLI" \
+  path/to/audio.wav \
+  --out transcript.txt
+```
+
+Diarization with known speakers (up to 4):
+```
+python3 "$TRANSCRIBE_CLI" \
+  meeting.m4a \
+  --model gpt-4o-transcribe-diarize \
+  --known-speaker "Alice=refs/alice.wav" \
+  --known-speaker "Bob=refs/bob.wav" \
+  --response-format diarized_json \
+  --out-dir output/transcribe/meeting
+```
+
+Plain text output (explicit):
+```
+python3 "$TRANSCRIBE_CLI" \
+  interview.mp3 \
+  --response-format text \
+  --out interview.txt
+```
+
+## Reference map
+- `references/api.md`: supported formats, limits, response formats, and known-speaker notes.

package/skills_ref/trello/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: trello
+description: Manage Trello boards, lists, and cards via the Trello REST API.
+homepage: https://developer.atlassian.com/cloud/trello/rest/
+metadata:
+  {
+    "openclaw":
+      { "emoji": "📋", "requires": { "bins": ["jq"], "env": ["TRELLO_API_KEY", "TRELLO_TOKEN"] } },
+  }
+---
+
+# Trello Skill
+
+Manage Trello boards, lists, and cards directly from OpenClaw.
+
+## Setup
+
+1. Get your API key: https://trello.com/app-key
+2. Generate a token (click "Token" link on that page)
+3. Set environment variables:
+   ```bash
+   export TRELLO_API_KEY="your-api-key"
+   export TRELLO_TOKEN="your-token"
+   ```
+
+## Usage
+
+All commands use curl to hit the Trello REST API.
+
+### List boards
+
+```bash
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
+```
+
+### List lists in a board
+
+```bash
+curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
+```
+
+### List cards in a list
+
+```bash
+curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
+```
+
+### Create a card
+
+```bash
+curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "idList={listId}" \
+  -d "name=Card Title" \
+  -d "desc=Card description"
+```
+
+### Move a card to another list
+
+```bash
+curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "idList={newListId}"
+```
+
+### Add a comment to a card
+
+```bash
+curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "text=Your comment here"
+```
+
+### Archive a card
+
+```bash
+curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "closed=true"
+```
+
+## Notes
+
+- Board/List/Card IDs can be found in the Trello URL or via the list commands
+- The API key and token provide full access to your Trello account - keep them secret!
+- Rate limits: 300 requests per 10 seconds per API key; 100 requests per 10 seconds per token; `/1/members` endpoints are limited to 100 requests per 900 seconds
+
+## Examples
+
+```bash
+# Get all boards
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq
+
+# Find a specific board by name
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("Work"))'
+
+# Get all cards on a board
+curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
+```

package/skills_ref/tts/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: tts
+description: "Text-to-speech using macOS built-in `say` command. Generate spoken audio from text with voice selection, speed control, and file output."
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🔊",
+        "requires": null,
+        "install": null,
+      },
+  }
+---
+
+# Text-to-Speech (macOS)
+
+Convert text to speech using the built-in `say` command. No dependencies required.
+
+## Quick Start
+
+```bash
+say "Hello world"                          # Speak text
+say -v Samantha "Hello world"              # Use specific voice
+say -o ~/output.aiff "Hello world"         # Save to file
+```
+
+## Commands
+
+### Speak Text
+
+```bash
+say "Text to speak"
+say -v Yuna "안녕하세요"                    # Korean voice
+say -v Samantha "Hello"                     # English voice (female)
+say -v Daniel "Hello"                       # English voice (male)
+say -r 200 "Fast speech"                    # Speed (words per minute, default: ~175)
+say -r 100 "Slow speech"
+```
+
+### Save to File
+
+```bash
+say -o ~/output.aiff "Hello world"                           # AIFF format
+say -o ~/output.aiff --data-format=LEF32@22050 "Hello"       # WAV-like format
+```
+
+### Convert to MP3/WAV (with ffmpeg)
+
+```bash
+say -o /tmp/speech.aiff "Hello world"
+ffmpeg -i /tmp/speech.aiff ~/speech.mp3    # Requires: brew install ffmpeg
+ffmpeg -i /tmp/speech.aiff ~/speech.wav
+```
+
+### List Available Voices
+
+```bash
+say -v '?'                                 # List all voices
+say -v '?' | grep en_                      # English voices only
+say -v '?' | grep ko_                      # Korean voices only
+```
+
+### Read from File
+
+```bash
+say -f ~/document.txt                      # Read file contents
+cat ~/document.txt | say                   # Pipe to say
+```
+
+## Common Voice Selections
+
+| Language     | Voice    | Example                     |
+| ------------ | -------- | --------------------------- |
+| English (US) | Samantha | `say -v Samantha "Hello"`   |
+| English (US) | Alex     | `say -v Alex "Hello"`       |
+| English (UK) | Daniel   | `say -v Daniel "Hello"`     |
+| Korean       | Yuna     | `say -v Yuna "안녕하세요"`  |
+| Japanese     | Kyoko    | `say -v Kyoko "こんにちは"` |
+
+## Advanced: External TTS (Optional)
+
+For higher quality or more voices, install sherpa-onnx:
+
+```bash
+brew install sherpa-onnx
+sherpa-onnx-offline-tts \
+  --vits-model=model.onnx \
+  --vits-tokens=tokens.txt \
+  --output-filename=output.wav \
+  "Text to speak"
+```
+
+## Notes
+
+- `say` is macOS-only (pre-installed, no setup needed).
+- Default voice depends on system language settings.
+- Audio plays through system speakers by default.
+- Use `-o` flag to save without playing.
+- For Telegram delivery, convert to OGG: `ffmpeg -i speech.aiff -c:a libopus speech.ogg`

package/skills_ref/vercel-deploy/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: vercel-deploy
+description: Deploy applications and websites to Vercel using the bundled `scripts/deploy.sh` claimable-preview flow. Use when the user asks to deploy to Vercel, wants a preview URL, or says to push a project live on Vercel.
+---
+
+# Vercel Deploy
+
+Deploy any project to Vercel instantly. No authentication required.
+
+## How It Works
+
+1. Packages your project into a `.tar.gz` (excludes `node_modules` and `.git`)
+2. Auto-detects framework from `package.json`
+3. Uploads to deployment service
+4. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
+
+## Usage
+
+```bash
+bash scripts/deploy.sh [path]
+```
+
+**Arguments:**
+- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
+
+If you pass a directory, the script will create a `.tar.gz` before upload.
+
+**Examples:**
+
+```bash
+# Deploy current directory
+bash scripts/deploy.sh
+
+# Deploy specific project
+bash scripts/deploy.sh /path/to/project
+
+# Deploy existing tarball
+bash scripts/deploy.sh /path/to/project.tgz
+```
+
+## Packaging Rules
+
+- Exclude `node_modules`, `.git`, and `.env*`
+- If no `package.json`, keep `framework` as `null`
+- For static HTML with a single `.html` file, rename it to `index.html` before packaging
+
+## Output
+
+```
+Preparing deployment...
+Creating deployment package...
+Deploying...
+✓ Deployment successful!
+
+Preview URL: https://skill-deploy-abc123.vercel.app
+Claim URL:   https://vercel.com/claim-deployment?code=...
+```
+
+The script also outputs JSON to stdout for programmatic use.
+
+```json
+{
+  "previewUrl": "https://skill-deploy-abc123.vercel.app",
+  "claimUrl": "https://vercel.com/claim-deployment?code=...",
+  "deploymentId": "dpl_...",
+  "projectId": "prj_..."
+}
+```
+
+## Framework Detection
+
+The script auto-detects frameworks from `package.json`. Supported frameworks include:
+
+- **React**: Next.js, Gatsby, Create React App, Remix, React Router
+- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
+- **Svelte**: SvelteKit, Svelte, Sapper
+- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
+- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
+- **Build Tools**: Vite, Parcel
+- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
+
+For static HTML projects (no `package.json`), framework is set to `null`.
+
+## Static HTML Projects
+
+For projects without a `package.json`:
+- If there's a single `.html` file not named `index.html`, it gets renamed automatically
+- This ensures the page is served at the root URL (`/`)
+
+## Present Results to User
+
+Always show both URLs:
+
+```
+✓ Deployment successful!
+
+Preview URL: https://skill-deploy-abc123.vercel.app
+Claim URL:   https://vercel.com/claim-deployment?code=...
+
+View your site at the Preview URL.
+To transfer this deployment to your Vercel account, visit the Claim URL.
+```
+
+## Troubleshooting
+
+### Network Egress Error
+
+If deployment fails due to network restrictions, tell the user:
+
+```
+Deployment failed due to network restrictions. To fix this:
+
+1. Allow outbound access to *.vercel.com
+2. Try deploying again
+```

package/skills_ref/video-downloader/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: youtube-downloader
+description: Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.
+---
+
+# YouTube Video Downloader
+
+Download YouTube videos with full control over quality and format settings.
+
+## Quick Start
+
+The simplest way to download a video:
+
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
+```
+
+This downloads the video in best available quality as MP4 to `/mnt/user-data/outputs/`.
+
+## Options
+
+### Quality Settings
+
+Use `-q` or `--quality` to specify video quality:
+
+- `best` (default): Highest quality available
+- `1080p`: Full HD
+- `720p`: HD
+- `480p`: Standard definition
+- `360p`: Lower quality
+- `worst`: Lowest quality available
+
+Example:
+```bash
+python scripts/download_video.py "URL" -q 720p
+```
+
+### Format Options
+
+Use `-f` or `--format` to specify output format (video downloads only):
+
+- `mp4` (default): Most compatible
+- `webm`: Modern format
+- `mkv`: Matroska container
+
+Example:
+```bash
+python scripts/download_video.py "URL" -f webm
+```
+
+### Audio Only
+
+Use `-a` or `--audio-only` to download only audio as MP3:
+
+```bash
+python scripts/download_video.py "URL" -a
+```
+
+### Custom Output Directory
+
+Use `-o` or `--output` to specify a different output directory:
+
+```bash
+python scripts/download_video.py "URL" -o /path/to/directory
+```
+
+## Complete Examples
+
+1. Download video in 1080p as MP4:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
+```
+
+2. Download audio only as MP3:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
+```
+
+3. Download in 720p as WebM to custom directory:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
+```
+
+## How It Works
+
+The skill uses `yt-dlp`, a robust YouTube downloader that:
+- Automatically installs itself if not present
+- Fetches video information before downloading
+- Selects the best available streams matching your criteria
+- Merges video and audio streams when needed
+- Supports a wide range of YouTube video formats
+
+## Important Notes
+
+- Downloads are saved to `/mnt/user-data/outputs/` by default
+- Video filename is automatically generated from the video title
+- The script handles installation of yt-dlp automatically
+- Only single videos are downloaded (playlists are skipped by default)
+- Higher quality videos may take longer to download and use more disk space