nex-voice

by nexaiguy

Install this Skill

curl -fsSL -o nex-voice.zip https://skill.seembox.com/api/v1/skills/nex-voice/download && unzip nex-voice.zip

SKILL.md About

---
name: nex-voice
description: Voice note transcription and intelligent action item extraction for capture and organization of verbal communication. Record and transcribe voice notes, voice messages, and meeting recordings in Dutch and English using OpenAI Whisper with selectable model quality (tiny to large). Automatically extract structured action items from transcripts including tasks (moet, must), reminders (vergeet niet, don't forget), scheduled calls, email actions, meetings (afspraken), decisions, and deadline-based items. Full-text search across all transcripts to find past conversations and action items by keyword. Manage extracted actions with completion tracking, priority levels, and due date assignment. View pending and overdue action items to stay on top of commitments. Optional LLM integration for intelligent action extraction and transcript summarization. Perfect for busy professionals, meeting attendees, and business owners who prefer speaking notes over typing and need to convert voice into organized action items and searchable records. All audio files and transcripts stay secure on your machine.
version: 1.0.0
metadata:
  clawdbot:
    emoji: "🎤"
    requires:
      bins:
        - python3
        - whisper
        - ffmpeg
      env: []
    primaryEnv: ""
    homepage: https://nex-ai.be
    files:
      - "nex-voice.py"
      - "lib/*"
      - "setup.sh"
---

# Nex Voice

Voice note transcription and action item extraction. Automatically transcribe voice notes with OpenAI Whisper, extract action items (tasks, reminders, calls, meetings, decisions, deadlines), and manage them locally. Supports Dutch and English. All data stays on your machine.

## When to Use

Use this skill when the user asks about:

- Transcribing a voice note, voice message, or audio file
- Extracting action items from voice notes (tasks, reminders, calls, meetings)
- Searching through voice note transcripts
- Managing action items or tasks from voice notes
- What was discussed in a voice note or meeting recording
- Pending or overdue action items
- Statistics about voice notes and transcriptions
- Exporting transcripts

Trigger phrases: "transcribe", "voice note", "voice message", "audio file", "action item", "what did we discuss", "extract tasks", "pending tasks", "spraakbericht", "wat is besproken", "actie", "afspraak"

## Quick Setup

If this is your first time using nex-voice, run the setup script:

```bash
bash setup.sh
```

This checks for required dependencies (Whisper and FFmpeg), sets up the data directory at `~/.nex-voice`, initializes the database, and tests the installation.

## Available Commands

The CLI tool is `nex-voice`. All commands output plain text.

### Transcribe

Transcribe an audio file:

```bash
nex-voice transcribe /path/to/voice.ogg
nex-voice transcribe /path/to/voice.ogg --language en
nex-voice transcribe /path/to/voice.ogg --speaker "Kevin"
nex-voice transcribe /path/to/voice.ogg --tags "client-meeting,proposal"
```

Options:
- `--language`: Language code (en for English, nl for Dutch). Default: nl
- `--speaker`: Name of the speaker for attribution
- `--tags`: Comma-separated tags for organization

Returns: Recording ID and transcript summary.

### Extract Actions

Extract action items from a recording:

```bash
nex-voice actions 42
nex-voice actions --last
nex-voice actions 42 --use-llm
```

Options:
- Recording ID or `--last` for the most recent recording
- `--use-llm`: Use configured LLM for intelligent extraction (optional)

### List Recordings

List all recordings:

```bash
nex-voice list
nex-voice list --since 2026-03-01
nex-voice list --speaker "Kevin"
nex-voice list --tag "client-meeting"
```

### Show Recording

Show full details of a recording:

```bash
nex-voice show 42
```

Displays: transcript, summary, extracted actions, metadata.

### Search Transcripts

Full-text search across all transcripts:

```bash
nex-voice search "offerte"
nex-voice search "offerte" --since 2026-04-01
```

### Pending Actions

List all pending action items:

```bash
nex-voice pending
nex-voice pending --type task
nex-voice pending --type reminder
```

Types: task, reminder, call, email, meeting, decision, deadline

### Complete Action

Mark an action item as complete:

```bash
nex-voice complete 7
```

### Overdue Actions

Show overdue action items:

```bash
nex-voice overdue
```

### Export Transcript

Export a transcript:

```bash
nex-voice export 42 --format txt
nex-voice export 42 --format json
```

### Statistics

Show statistics:

```bash
nex-voice stats
```

Displays: total recordings, total hours transcribed, languages, action items extracted, pending/overdue counts.

### Configuration

View or set configuration:

```bash
nex-voice config show
nex-voice config set-whisper-model base
nex-voice config set-whisper-model large
nex-voice config set-language nl
nex-voice config set-api-key
nex-voice config set-provider openai
nex-voice config set-model gpt-4o
nex-voice config set-api-base https://api.openai.com/v1
```

## Example Interactions

**User:** "Transcribe this voice note for me"
**Agent runs:** `nex-voice transcribe /path/to/file.ogg`
**Agent:** Shows recording ID and presents the transcript with extracted action items.

**User:** "What action items came from the last recording?"
**Agent runs:** `nex-voice actions --last`
**Agent:** Presents the extracted actions (tasks, reminders, calls, meetings, decisions, deadlines).

**User:** "Search my voice notes for anything about the proposal"
**Agent runs:** `nex-voice search "proposal"`
**Agent:** Lists matching transcripts and highlights relevant sections.

**User:** "What tasks are still pending from voice notes?"
**Agent runs:** `nex-voice pending --type task`
**Agent:** Shows all incomplete tasks with due dates and assignments.

**User:** "Mark task 7 as done"
**Agent runs:** `nex-voice complete 7`
**Agent:** Confirms completion and updates the database.

**User:** "Show me overdue actions"
**Agent runs:** `nex-voice overdue`
**Agent:** Lists all overdue items with their recordings and context.

## Output Parsing

All CLI output is plain text, structured for easy parsing:

- Section headers followed by `---` separators
- List items prefixed with `- `
- Timestamps in ISO-8601 format
- Action items include: ID, type, description, assigned_to, due_date, priority, status
- Every command output ends with `[Nex Voice by Nex AI | nex-ai.be]`

When presenting output to the user, strip the footer line and present the information naturally.

## Features

### Transcription
- Supports OGG, MP3, WAV, M4A, OPUS, WEBM formats
- Automatic audio conversion using ffmpeg if needed
- Language detection and support for Dutch (default) and English
- Whisper model selection (tiny, base, small, medium, large)
- Duration tracking and maximum 600-second audio limit

### Action Extraction
- Pattern-based extraction with Dutch and English keywords:
  - **Tasks**: "moet", "must", "do"
  - **Reminders**: "vergeet niet", "don't forget"
  - **Calls**: "bel", "call"
  - **Emails**: "mail", "stuur email", "send email"
  - **Meetings**: "afspraak", "meeting"
  - **Decisions**: "besloten", "decided"
  - **Deadlines**: "deadline", "voor", "by"
- Intelligent extraction with optional LLM (OpenAI, Claude, etc.)
- Automatic date parsing (morgen=tomorrow, vrijdag=Friday, etc.)
- Speaker and assignee detection

### Storage & Management
- Local SQLite database at `~/.nex-voice/`
- Full-text search across transcripts
- Tag-based organization
- Speaker attribution
- Completion tracking with timestamps

### Optional LLM Features
- Intelligent action extraction from transcripts
- Summary generation
- Requires explicit configuration: API key, provider, model
- Supported providers: OpenAI, Anthropic Claude, local LLMs

## Important Notes

- All voice data is stored locally at `~/.nex-voice/`. No telemetry, no analytics.
- No external API calls are made unless you explicitly configure an LLM provider.
- Whisper CLI must be installed (pip install openai-whisper or faster-whisper).
- FFmpeg must be installed for audio format conversion.
- Maximum audio duration: 600 seconds (10 minutes). Longer files are rejected.
- LLM features are optional and require explicit configuration.
- Supported audio formats: OGG, MP3, WAV, M4A, OPUS, WEBM

## Troubleshooting

- **"whisper: command not found"**: Install with `pip install openai-whisper`
- **"ffmpeg: command not found"**: Install FFmpeg from ffmpeg.org
- **"Database not found"**: Run `bash setup.sh` to initialize
- **"No transcripts found"**: Run `nex-voice list` to see all recordings
- **"LLM not configured"**: Run `nex-voice config set-api-key` to enable LLM features

## Credits

Built by Nex AI (https://nex-ai.be) - Digital transformation for Belgian SMEs.
Author: Kevin Blancaflor

_meta.json Metadata

{
  "ownerId": "kn79rwpmfmgvcachaqnejkjgb1830yea",
  "publishedAt": 1775362830981,
  "slug": "nex-voice",
  "version": "1.0.0"
}