How do I install the Sori Recorder skill?

Run npx skillmds@latest add yoochankim/sori-recorder in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sori Recorder safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sori Recorder?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sori Recorder free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sori Recorder?

yoochankim (@yoochankim) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sori Recorder by yoochankim — Agent Skill

Name: Sori Recorder
Author: yoochankim

Sori Recorder

Operate the installed Sori macOS recorder and hand a verified recording to a user-approved follow-up workflow. Use when the user asks to start or stop recording, check status or audio levels, choose a microphone, list or verify recordings, or continue work from a Sori recording. This skill does not transcribe audio or change Sori source code.

yoochankim Updated Sep 17, 2026

File contents

Sori recorder

Use Sori's local CLI and request JSON output when reading results programmatically.

Boundaries

A direct request to record is authorization to start. Do not start from calendar context, ambient conversation, or an inferred meeting.
The user may authorize recording and a named follow-up action in the same request. Do not infer an action they did not name.
Uploading, sharing, attaching, or transcribing audio requires an explicit request for that action.
If a follow-up tool needs to upload audio, name the service and get approval before sending the files unless the user already approved that service.
Do not change macOS privacy permissions, switch microphones, or delete recordings unless the user asks.
Keep exact error messages. Do not report success before the CLI returns ok: true.

Start and monitor

Check state before starting:

sori status --json

If Sori is already recording, report the active folder instead of starting another recording. Otherwise run:

sori start --json

Keep the returned folder path. While recording, use sori status --json for elapsed time, selected devices, and audio levels. If the microphone is silent, report the selected device without changing it.

If start times out, run sori status --json before retrying. A late start must not create a second recording.

Stop and verify

Run:

sori stop --json

Wait for ok: true. The stop response means both WAV files were finalized. Read meta.json in the returned folder and verify that status is done, then report the folder and duration.

Do not open or process mic.wav or system.wav unless the user requested work on the audio.

Continue from a completed recording

If the user already requested a follow-up action, hand the verified recording folder to the relevant available skill or tool. Keep the work local when the user requested local processing. Sori does not provide transcription itself, so do not claim that this skill can transcribe or summarize audio.

If the user did not specify what happens next, offer these options once:

Leave the recording untouched.
Transcribe it.
Summarize it or extract decisions and action items.
Export or share it with a destination the user names.

Wait for the user's choice before opening either WAV file. Apply the choice only to the recording folder you just reported or one the user explicitly selects. If transcription is requested without a method, use an available local tool. If only an external service is available, name it and ask before uploading.

Find recordings and choose a microphone

Use:

sori list --json
sori devices --json

Use sori set-mic <NAME> --json only after the user chooses that device. Use sori set-mic auto --json when the user wants Sori to follow the default physical microphone.

Recordings are under ~/Sori/recordings. Each folder contains mic.wav, system.wav, and meta.json. If a command fails, check sori status --json before another state-changing command.

---name: sori-recorderdescription: Operate the installed Sori macOS recorder and hand a verified recording to a user-approved follow-up workflow. Use when the user asks to start or stop recording, check status or audio levels, choose a microphone, list or verify recordings, or continue work from a Sori recording. This skill does not transcribe audio or change Sori source code.---# Sori recorderUse Sori's local CLI and request JSON output when reading results programmatically.## Boundaries- A direct request to record is authorization to start. Do not start from calendar context, ambient conversation, or an inferred meeting.- The user may authorize recording and a named follow-up action in the same request. Do not infer an action they did not name.- Uploading, sharing, attaching, or transcribing audio requires an explicit request for that action.- If a follow-up tool needs to upload audio, name the service and get approval before sending the files unless the user already approved that service.- Do not change macOS privacy permissions, switch microphones, or delete recordings unless the user asks.- Keep exact error messages. Do not report success before the CLI returns `ok: true`.## Start and monitorCheck state before starting:```shsori status --json```If Sori is already recording, report the active folder instead of starting another recording. Otherwise run:```shsori start --json```Keep the returned folder path. While recording, use `sori status --json` for elapsed time, selected devices, and audio levels. If the microphone is silent, report the selected device without changing it.If start times out, run `sori status --json` before retrying. A late start must not create a second recording.## Stop and verifyRun:```shsori stop --json```Wait for `ok: true`. The stop response means both WAV files were finalized. Read `meta.json` in the returned folder and verify that `status` is `done`, then report the folder and duration.Do not open or process `mic.wav` or `system.wav` unless the user requested work on the audio.## Continue from a completed recordingIf the user already requested a follow-up action, hand the verified recording folder to the relevant available skill or tool. Keep the work local when the user requested local processing. Sori does not provide transcription itself, so do not claim that this skill can transcribe or summarize audio.If the user did not specify what happens next, offer these options once:- Leave the recording untouched.- Transcribe it.- Summarize it or extract decisions and action items.- Export or share it with a destination the user names.Wait for the user's choice before opening either WAV file. Apply the choice only to the recording folder you just reported or one the user explicitly selects. If transcription is requested without a method, use an available local tool. If only an external service is available, name it and ask before uploading.## Find recordings and choose a microphoneUse:```shsori list --jsonsori devices --json```Use `sori set-mic <NAME> --json` only after the user chooses that device. Use `sori set-mic auto --json` when the user wants Sori to follow the default physical microphone.Recordings are under `~/Sori/recordings`. Each folder contains `mic.wav`, `system.wav`, and `meta.json`. If a command fails, check `sori status --json` before another state-changing command.

Frequently asked questions