Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/remotehumans/riff/riff-setupnpx skills add remotehumans/riff --skill riff-setupgit clone --depth 1 https://github.com/remotehumans/riffWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/remotehumans/riff/riff-setup)<a href="https://agentmods.dev/skills/remotehumans/riff/riff-setup"><img src="https://agentmods.dev/badge/skills/remotehumans/riff/riff-setup.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00086 | $0.00790 |
| Opus 5 | $0.00043 | $0.00395 |
| Sonnet 5 | $0.00017 | $0.00158 |
| Haiku 4.5 | $0.00009 | $0.00079 |
Grade A, and why
riff-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Riff Setup
Set up Riff for hands-free interaction with AI agents and apps. Riff has two independent components that can be installed separately or together:
- Riff Bridge - Maps a JX-11 Bluetooth smart ring to keyboard events (voice recording toggle, send, delete, scroll, interrupt)
- Riff Voice - Speaks AI agent output aloud using on-device TTS (Kokoro via MLX on Apple Silicon)
Setup Workflow
1. Determine which components to install
Ask the user which components they want:
- Riff Bridge only - Control AI agents or any app by voice using the smart ring. Read output on screen.
- Riff Voice only - Type normally at the desk. Hear AI agent output spoken aloud.
- Both - Full hands-free loop: speak via ring, hear responses via Riff Voice.
If unclear, recommend starting with Riff Bridge - it's the core hands-free experience.
2. Check prerequisites
Read references/setup-guide.md for the full prerequisite checklist per component. Verify each prerequisite before proceeding. Key checks:
Riff Bridge: Verify swiftc --version works, confirm JX-11 ring is paired in Bluetooth settings, confirm user has a voice-to-text app installed.
Riff Voice: Verify uname -m returns arm64 (Apple Silicon required), verify Python 3.10+, verify uv is installed.
3. Install the selected components
Follow the step-by-step installation in references/setup-guide.md. Run the commands and verify each step before proceeding to the next.
For Riff Bridge:
cd riff-bridge
make all && make install
Then guide the user through granting Input Monitoring and Accessibility permissions.
For Riff Voice:
cd riff-voice
make install
Then verify with riff-say "Riff Voice is working".
4. Configure key mappings (Riff Bridge)
After installation, ask the user:
- Which voice-to-text app they use
- What keyboard shortcut their app uses for push-to-talk
If their app's shortcut differs from Option key (the default), modify riff_bridge.swift to match. See references/setup-guide.md for the constants to change and common macOS virtual keycodes.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 81 lines · 86 tokens per session scan A 88ff252ffb24
riff-setup is a skill published in the GitHub repository remotehumans/riff (24 stars, last pushed 21d ago), licensed MIT. It adds 86 tokens to every session and 790 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
integrated-browser
Use this when working on the VS Code integrated browser ("browserView") to understand its architecture and mental model. Covers the embedded Chromium browser, its editor tab, navigation, overlay/layout, sessions, and agent browser tools under src/vs/platform/browserView and src/vs/workbench/contrib/browserView.
import-prom-rule
Bulk import of a Prometheus alert rule YAML file (create a whole set of rules at once). Dedicated to handling a remote URL or local YAML text, automatically parsing the three formats groups / a plain rules array / a single rule. ⚠️ Do not use this skill for single-rule creation — when the user describes a single alert…
pcbway
PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…
unifi-protect
How to manage UniFi Protect cameras and NVR — view cameras, smart detections, Find Anything detection search, recordings, snapshots, lights, sensors, Known Faces, license plates, and the Alarm Manager. Use this skill when the user mentions UniFi cameras, security cameras, NVR, recordings, motion detection, person…
tilelang-env-check
TileLang-Ascend 环境检查与配置验证技能。检查代码仓库完整性、编译安装状态、环境变量配置，并运行简单测试验证环境。发现问题会自动调用相关 skill 进行修复，并按依赖顺序重新执行后续步骤。触发关键词："环境检查"、"检查环境"、"验证环境"、"环境配置"、"环境搭建"、"env check"、"check environment"、"verify environment"、"setup environment"。.
KernelWiki
Use when the user asks about optimizing NVIDIA Blackwell (SM100, B200) or Hopper (SM90, H100) GPU kernels — tcgen05/TMEM/CLC/NVFP4/2-SM cooperative, warp specialization, FlashAttention-4, DeepGEMM, FlashMLA, MoE, grouped GEMM, CuTe-DSL/PTX/Triton on Blackwell, or wants concrete PR references from…