voice

Configure voice-activated workflows using whisper.cpp, sox, and Hammerspoon for hands-free task management.

13|4|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/ggombee/code-forge --skill voice-ggombee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voice
Source: https://github.com/ggombee/code-forge/tree/main/skills/voice
Command: npx skills add https://github.com/ggombee/code-forge --skill voice-ggombee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires whisper-cpp, sox, Hammerspoon, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit addresses the need for hands-free productivity by offering voice input setup and management, enabling users with arm injuries or RSI to perform family workflow tasks through voice commands. It integrates whisper.cpp, sox, and Hammerspoon to create a voice-activated workflow.

Core Features & Use Cases

  • Voice Input Setup: One-time setup of dependencies, models, and Hammerspoon configuration.
  • Command Execution: Execute commands through voice, leveraging Hammerspoon integration.
  • Status and Verification: Check the status, test the setup, and troubleshoot with the /voice test command.
  • Uninstallation: Remove the voice setup and clean up configurations.
  • Use Case: A user with arm injuries can manage tasks like creating, editing, and reviewing documents without physical interaction, enhancing productivity and comfort.

Quick Start

Set up the voice input by running '/voice setup' and verify the functionality with '/voice test'.

Frequently Asked Questions about voice

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

FAQPage Schema
How do I set up hands-free voice automation on my desktop?

Hands-free voice automation is set up by running the `/voice setup` command, which configures whisper.cpp for speech-to-text, sox for sound processing, and Hammerspoon for desktop automation. You can verify the setup by running `/voice test`.

What dependencies do I need for voice-activated workflow management?

Voice-activated workflow management requires three dependencies: whisper.cpp for speech-to-text conversion, sox for audio processing, and Hammerspoon for executing desktop automation commands. The setup command handles the installation and configuration of these components.

Can I use whisper.cpp with Hammerspoon for speech-to-text input?

Yes, this integrates whisper.cpp with Hammerspoon to enable speech-to-text input. Whisper.cpp processes the audio captured by sox into text, which Hammerspoon then uses to trigger and execute desktop automation commands.

Is there a way to test and troubleshoot my voice input setup?

Yes, you can test and troubleshoot your voice input setup by running the `/voice test` command. This verifies the status of your whisper.cpp, sox, and Hammerspoon configuration to ensure hands-free productivity is functioning correctly.

How do I uninstall the voice automation setup and clean up configurations?

You can uninstall the voice automation setup and clean up configurations using the uninstall command. This removes the Hammerspoon integration and other dependencies configured during the initial voice input setup process.

Why use voice commands for desktop automation instead of keyboard shortcuts?

Voice commands for desktop automation provide hands-free productivity, which is essential for users with arm injuries or RSI. It allows you to create, edit, and review documents through voice-activated workflows without physical keyboard interaction.