Voice Skill - Talk to Claude About Your Code

When to Use This Skill

• Discussing complex code problems hands-free
• Brainstorming architecture decisions
• Getting verbal code reviews
• Explaining code while walking/commuting
• Pair programming via voice
• Quick questions without typing

How It Works

1. Claude Calls You: Initiate outbound calls from Claude
2. You Call Claude: Call your Vapi number to reach Claude
3. Live Context: Claude has access to your project during calls
4. Transcripts: All calls automatically saved as markdown

Setup

Prerequisites

• Vapi account with API key
• Phone number (~$2/month)
• Node.js (for localtunnel)
• Python 3.8+

1. Install

pip install claude-code-voice-skill

2. Setup Credentials

voice-skill setup

• Vapi API key
• Your phone number
• Your name (for personalized greetings)

3. Register Project

cd /path/to/your/project
voice-skill register

4. Start Service

voice-skill start

Commands

Have Claude Call You

voice-skill call

Check Status

voice-skill status

Update Name

voice-skill config name "Your Name"

View Transcripts

ls ~/.voice-skill/transcripts/

What Claude Can Do During Calls

Read Files

Search Code

Check Git Status

Review Code

Brainstorm

Example Conversation

[Phone rings]

Claude: "Hey Alex! I see you're working on the user-service
project. What would you like to discuss?"

You: "I'm having trouble with the authentication middleware.
Can you take a look at auth.py?"

Claude: "Sure, let me read that... I see you're using JWT
tokens. The issue might be on line 45 where you're checking
the expiry. You're comparing timestamps in different formats..."

You: "Oh, that makes sense. What's the fix?"

Claude: "You should convert both to Unix timestamps before
comparing. I'd suggest using datetime.timestamp() on line 45..."

Transcripts

# Call Transcript - 2025-01-12 10:30 AM

**Project:** user-service
**Duration:** 8 minutes

## Summary
Discussed JWT authentication bug in auth.py.
Identified timestamp comparison issue on line 45.

## Full Transcript

**Claude:** Hey Alex! I see you're working on...
**You:** I'm having trouble with...
...

Configuration

Config File Location

~/.voice-skill/config.yaml

Options

user:
  name: "Your Name"
  phone: "+1234567890"

vapi:
  api_key: "your-key"
  phone_number: "+1987654321"

preferences:
  greeting_style: casual  # casual, professional
  auto_transcript: true
  transcript_dir: ~/.voice-skill/transcripts

Voice Provider Options

• Default Vapi voices
• ElevenLabs integration
• Custom voice configurations

Security

• API keys stored locally
• Calls encrypted via Vapi
• Transcripts stored locally only
• No data sent to third parties (beyond Vapi)

Troubleshooting

"Connection failed"

• Check internet connection
• Verify Vapi API key
• Restart with

  voice-skill start

"Project not found"

• Run

  voice-skill register

  in project directory

"Call not connecting"

• Verify phone number format (+country code)
• Check Vapi account balance

Use Cases

• Code Reviews: Verbal feedback while looking at code
• Debugging: Talk through problems out loud
• Architecture: Discuss design decisions
• Learning: Explain code concepts
• Accessibility: Hands-free coding assistance

Credits