Intake Skill

---
name: intake-skill
description: >-
  Install, verify, operate, and debug the Apple Voice Memos Intake Skill via python -m intake_skill.
disable-model-invocation: true
---

# Intake Skill

Use this skill when a user asks an AI agent to install or operate the Intake Skill repo. The expected user request is:

```text
Install this repo for me: https://github.com/grapeot/intake-skill
```

The job is complete only after the repo is cloned as a project-local skill, the local CLI is installed, tests pass, real local ASR has been installed and verified, a sample audio file has gone through sync, MLX Qwen3 ASR, and Codex postprocessing end to end, the operator has been shown where the output files are, and the operator has made an explicit choice about the optional nightly automatic run.

When talking to the operator, keep the cognitive burden low. Prefer phrases like "nightly automatic run", "runs every night", or "daily background run" instead of leading with terms such as "cron", "cron job", or "crontab". Use the technical terms only when showing exact commands, errors, or backup files. Explain setup as: "I can set this up to run once every night while your Mac is awake."

## Scope and Runtime Defaults

Intake Skill is Voice Memos only. It reads files that Apple Voice Memos has already synced to the Mac. Do not add microphone recording, non-Voice-Memos sources, speaker recognition, diarization, reference voices, or participant attribution.

Mock engines are retained for unit tests and explicit offline debugging. Functional setup and operation should use MLX Qwen3 ASR and Codex postprocessing by default. Before processing real Voice Memos, verify Codex with a trivial non-private prompt and validate Codex postprocessing on synthetic sample audio.

## Install from GitHub

Start in the user's current workspace and install this repo as a project-local skill, not as a standard global Codex skill. If `skills/intake-skill` already exists, inspect it rather than cloning over it.

```bash
mkdir -p skills
git clone https://github.com/grapeot/intake-skill.git skills/intake-skill
cd skills/intake-skill
uv venv .venv
source .venv/bin/activate
uv pip install -e '.[dev,qwen-asr]'
python -m pytest -q
python -m intake_skill --help
```

If `uv` is missing, install `uv` first by the user's normal package manager or mark setup blocked with the exact reason. Do not switch to a global `pip install` unless the user explicitly requests it.

## First-Run Setup Gate

Run `doctor` and inspect the JSON before touching private audio: