audio-recorder

Manage microphone recordings with sox into labeled OGG files.

Updated Aug 23, 2026

Search Tags:#recording #pid #label #sox #ogg

Ready to run

npx skills add https://github.com/smorand/claude-config --skill audio-recorder

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: audio-recorder
Source: https://github.com/smorand/claude-config/tree/main/skills/audio-recorder
Command: npx skills add https://github.com/smorand/claude-config --skill audio-recorder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables reliable microphone-based audio recording with single-script control, label-based naming, and automatic single-instance enforcement.

Core Features & Use Cases

Single recording enforcement: Only one recording active at a time via a PID file.
Label-based naming: Descriptive filenames for easy organization.
Status, list, and stop: Check active recording, list all recordings, and stop cleanly.

Quick Start

Start a recording with a label, then stop it when the meeting ends.

Frequently Asked Questions about audio-recorder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I record audio from my microphone and save it with a descriptive label?▼

Audio recording with descriptive labels uses sox to capture microphone input into labeled OGG files. Start a recording by providing a label, which automatically generates a timestamped filename for easy organization and later retrieval of your meeting or conversation recordings.

Can I have multiple audio recordings running at the same time?▼

No, this Skill enforces single-instance recording via PID tracking. Only one recording can be active at a time. Starting a new recording automatically stops and replaces any existing active recording, preventing conflicts and ensuring clean audio capture.

How do I check the status of an active recording or list all saved recordings?▼

The Skill provides status queries to check active recordings and list all saved recordings. You can view which recording is currently running, extract details from the running process, and browse your complete archive of labeled OGG files organized by timestamp.

What happens if a recording process crashes or becomes stale?▼

The Skill handles stale PIDs automatically, detecting when a recording process is no longer running. It cleans up invalid process references so you can start fresh recordings without manual intervention or lingering process conflicts.

Can I rename recording labels after they're saved?▼

Yes, label renaming is supported after recording. You can update the descriptive names of your saved OGG files to better organize or clarify your audio archive without re-recording or manually managing filenames.

What audio format does this Skill use for recordings?▼

Recordings are saved as OGG files, a compressed audio format that balances quality and file size. OGG encoding via sox ensures efficient storage while maintaining audio clarity for meetings and conversations.