Agent skill

Dotty Av Test

by BrettKinny in BrettKinny/dotty-stackchan

Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

MITAuto-check: notesMedia & Creative

Install Dotty Av Test

skills CLI
$ npx skills add BrettKinny/dotty-stackchan --skill dotty-av-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BrettKinny/dotty-stackchan dotty-av-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BrettKinny/dotty-stackchan.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dotty-av-test .claude/skills/dotty-av-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dotty-av-test
GitHub stars
113
Token cost
~866 tokens
SKILL.md length
435 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

  • Works in 4 steps: The user must have explicitly requested… → Run scripts/dotty-av-test.sh devices.… → Run scripts/dotty-av-test.sh volume and… → …
  • Testing Dottys wake word
  • SKILL.md covers Before playback, Run and evaluate and Bench observations from…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dotty Av Test is an agent skill from BrettKinny/dotty-stackchan. Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio. Use when testing Dotty's wake word, ASR, spoken response, expressions, or end-to-end voice behavior on this bench.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Text to speech and voice and Speech recognition and synthesis. It works with ESP32. The repository describes itself as: Self-hosted voice-assistant stack for the M5Stack StackChan desktop robot. Local ASR/TTS, pluggable LLM brain, kid-mode default, no cloud required. The licence is MIT.

When your agent uses it

  • Testing Dottys wake word
  • Spoken response
  • End-to-end voice behavior on this bench

Example prompts

  • “/dotty-av-test”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. The user must have explicitly requested recording. Keep captures local
  2. Run scripts/dotty-av-test.sh devices. Prefer the stable C920 index-0 path
  3. Run scripts/dotty-av-test.sh volume and let the user choose or confirm the
  4. Confirm espeak-ng, FFmpeg, pw-play, pactl, v4l2-ctl, and ALSA are

What it can do on your machine

Read from SKILL.md and the folder at commit cdf61b5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dotty Av Test loads about 866 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 435 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~866

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:23
    installed with `sudo pacman -S --needed espeak-ng`; the human may need to run
  • NoteRuns commands with sudoSKILL.md:24
    that command because sudo requires their password.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BrettKinny/dotty-stackchan at commit cdf61b5, republished under its MIT licence (© BrettKinny). 435 words, ~866 tokens.

Download SKILL.mdSave it as .claude/skills/dotty-av-test/SKILL.md (or your agent's skills folder).
name
dotty-av-test
description
Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio. Use when testing Dotty's wake word, ASR, spoken response, expressions, or end-to-end voice behavior on this bench.

Dotty A/V Test

Use the repository harness at scripts/dotty-av-test.sh; do not recreate its FFmpeg, ALSA, PipeWire, volume-safety, or verification logic ad hoc. Read docs/dotty-av-tests.md when choosing prompts or running a multi-case session.

Before playback

  1. The user must have explicitly requested recording. Keep captures local unless they separately request sharing or upload.
  2. Run scripts/dotty-av-test.sh devices. Prefer the stable C920 index-0 path and its hw:C920,0 microphone; index 1 is commonly metadata-only.
  3. Run scripts/dotty-av-test.sh volume and let the user choose or confirm the speaker level, then run speaker-test. Do not infer that a successful playback process means the user heard a comfortable level.
  4. Confirm espeak-ng, FFmpeg, pw-play, pactl, v4l2-ctl, and ALSA are available. On this Omarchy workstation, the missing TTS dependency is installed with sudo pacman -S --needed espeak-ng; the human may need to run that command because sudo requires their password.

The currently observed hardware is a Logitech C920 (1280x720 MJPEG video; 32 kHz, two-channel S16_LE microphone) and a Volt 4 default PipeWire sink. Rediscover rather than assuming those devices remain connected.

Run and evaluate

Run one test at a time:

bash
scripts/dotty-av-test.sh run "Hi E S P. What is your name?" 20

The harness creates a timestamped MP4 under uat-sessions/<date>/av/, provides two seconds of pre-roll, plays offline TTS, leaves the configured response window, then reports stream metadata and audio levels.

Inspect representative frames when visible state or expression matters. Treat these as separate assertions:

  • capture passed: non-zero video and audio streams with expected durations;
  • playback passed: the prompt was audibly clear at the intended position;
  • interaction passed: Dotty entered listening, understood the prompt, replied, animated appropriately, and recovered to idle.

Never report the interaction as passed merely because the MP4 and audio signal exist. Record silence/non-response as an interaction failure or deferred diagnostic while preserving a successful capture result.

Show full SKILL.md (145 more words)Show less

Bench observations from 2026-09-12

  • A 26-second full run produced valid H.264 1280x720 video and 32 kHz stereo AAC audio, with mean level -26.2 dB and peak -1.4 dB.
  • The user found 20% Volt output too soft, so future sessions must recalibrate with the user; do not silently reuse 20%.
  • Dotty did not respond to espeak-ng saying “Hi E S P. What is your name?” at that level. Wake-word pronunciation, level, placement, or live Dotty state remain unproven and should be diagnosed separately.
  • ALSA reported buffer xruns during that run even though both encoded streams had complete 26-second durations. Note repeated xruns and inspect the media; do not discard a complete recording solely because of that warning.

Do not change device permissions, reload drivers, record indefinitely, or overwrite an existing capture without specific authorization.

This skill was drafted by OpenAI Codex from a human-observed bench test.

© BrettKinny, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/dotty-av-test of BrettKinny/dotty-stackchan.

Open the folder on GitHubat commit cdf61b5

Compare with similar skills

Dotty Av Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dotty Av Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dotty Av Test this skillBrettKinny/dotty-stackchan113—~866Automated safety check: NotesMIT
Video Cutzenstory-ai/video-recap-skills559—~1.6kAutomated safety check: PassMIT
Local AI Useamd/skills406—~5kAutomated safety check: NotesMIT
Arkcli Code Examplevolcengine/ark-cli140—~743Automated safety check: PassApache-2.0
Voice AI Developmentdavila7/claude-code-templates32k5 repos~2.1kAutomated safety check: PassMIT
Arkcli Deployvolcengine/ark-cli140—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Video Cut

    zenstory-ai/video-recap-skills

    把长视频按 Agent 选择的原片区间剪成短片。作为两阶段创作流程中的剪辑环节,读取 clipplan.json 与源视频, 输出 editedsource.mp4;随后 Agent 按输出时间线写 narration.json。支持单视频与多视频(sources manifest)拼剪, 本工具不读取、不映射旁白。

    559 GitHub stars~1.6k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Local AI Use

    amd/skills

    Makes this agent generate images, transcribe audio, and synthesize speech on the user's own machine through a local Lemonade Server instead of a paid cloud API.

    406 GitHub stars~5k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Arkcli Code Example

    volcengine/ark-cli

    arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli…

    140 GitHub stars~743 tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Voice AI Development

    davila7/claude-code-templates

    Expert in building voice AI applications - from real-time voice agents to voice-enabled apps.

    32k GitHub starsUsed in 5 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Arkcli Deploy

    volcengine/ark-cli

    arkcli +deploy:普通创建推理接入点(Endpoint)的统一首选入口。用户说『创建/新建/create 一个 endpoint/接入点』或『部署/上线/deploy 某模型』时优先走这里;但脚本化 / CI / 无护栏 / 原始 raw CRUD 创建是唯一例外,必须改走 arkcli-infer-endpoint,不能由本 skill…

    140 GitHub stars~2.6k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Integrates local AI capabilities into applications using Embeddable Lemonade.

    406 GitHub stars~6k tokensUpdated today
    Media & CreativeAuto-check passed

Works with

Questions about Dotty Av Test

What does Dotty Av Test do?

Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio. Dotty Av Test is an agent skill from BrettKinny/dotty-stackchan. Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

When should I use Dotty Av Test?

Dotty Av Test fits situations like: testing Dottys wake word; spoken response; end-to-end voice behavior on this bench.

How do I install Dotty Av Test in Claude Code?

Run `npx skills add BrettKinny/dotty-stackchan --skill dotty-av-test -a claude-code`. Or copy the skill folder (skills/dotty-av-test in BrettKinny/dotty-stackchan) into .claude/skills/dotty-av-test in your project. Claude Code loads it when a task matches its description.

How do I install Dotty Av Test in Codex?

Run `npx skills add BrettKinny/dotty-stackchan --skill dotty-av-test -a codex`. Or copy the skill folder (skills/dotty-av-test in BrettKinny/dotty-stackchan) into .agents/skills/dotty-av-test in your project. Codex loads it when a task matches its description.

Can I use Dotty Av Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BrettKinny/dotty-stackchan --skill dotty-av-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dotty-av-test, .gemini/skills/dotty-av-test, .github/skills/dotty-av-test and .opencode/skills/dotty-av-test in your project.

What does Dotty Av Test need to run?

SKILL.md names no scripts, command-line tools or credentials: Dotty Av Test is instructions for the agent only.

Does Dotty Av Test access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dotty Av Test safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Dotty Av Test use?

Dotty Av Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dotty Av Test use?

About 866 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dotty Av Test?

Skills that share tags, products or a category with Dotty Av Test: Video Cut (zenstory-ai/video-recap-skills, 559 stars), Local AI Use (amd/skills, 406 stars), Arkcli Code Example (volcengine/ark-cli, 140 stars) and Voice AI Development (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dotty Av Test?

BrettKinny (a GitHub user) maintains it in BrettKinny/dotty-stackchan, which has 113 GitHub stars. The repository was last updated on October 5, 2026.

Source: BrettKinny/dotty-stackchan on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.