Installation

ReadyCheck installs as a Claude Code plugin. Here’s everything you need to know.

Prerequisites

  • Claude Code — ReadyCheck runs as a Claude Code plugin
  • macOS — Apple Silicon (arm64) or Intel (x86_64)

Install the Plugin

claude plugin install readycheck@wezzard-skills

This installs ReadyCheck and makes three skills available: /check, /analyze, and /doctor.

Verify Installation

Run the doctor to make sure everything is set up:

/doctor

The doctor checks:

ComponentRequired ForFix
Frida agent libraryFunction tracingIncluded with plugin
OpenAI WhisperVoice transcriptionbrew install openai-whisper
FFmpegScreen capture processingbrew install ffmpeg

Optional Dependencies

OpenAI Whisper

Required for voice analysis. Install via Homebrew:

brew install openai-whisper

FFmpeg

Required for screen recording processing:

brew install ffmpeg

Permissions

When you first run a capture, macOS will prompt for:

  • Screen Recording permission — for capturing the screen
  • Microphone access — for recording voice narration

These permissions are requested at runtime, not during installation.

Troubleshooting

If something isn’t working, run /doctor first. It will identify exactly what’s missing and provide fix commands.

For common issues:

  • “Frida agent not found” — The plugin installation may be incomplete. Try reinstalling.
  • “Whisper not found” — Install with brew install openai-whisper
  • “FFmpeg not found” — Install with brew install ffmpeg