VivaDictaVivaDicta

CLI Skills for Agents

Drop-in skill pack that teaches Claude Code, Cursor, Codex, and other agents how to use the vivadicta CLI.

Agent skills are short markdown playbooks that teach AI assistants when and how to call a tool. The official vivadicta-cli-skills pack drops four skills into Claude Code, Cursor, Codex CLI, Gemini CLI, Pi, or any other stdio agent that supports the SKILL.md format - so your assistant knows to reach for vivadicta when you say “summarise yesterday's standup” or “transcribe that YouTube link.”

One install: npx skills add n0an/vivadicta-cli-skills --global. Just markdown instructions - no processes to run, no background services, works across agents.

Prerequisites

The skills drive the vivadicta CLI, so you need both installed first:

  1. Install VivaDicta.app from the DMG at vivadicta.com.
  2. Install the CLI: brew install n0an/tap/vivadicta.
  3. Check: vivadicta recent 5.

See the CLI docs for full setup details. Write skills (vivadicta-transcribe-flow, vivadicta-search-and-rewrite) also require the VivaDicta UI app to be running, since writes route through a socket into the live app.

Install

All four skills, all agents

npx skills add n0an/vivadicta-cli-skills --global

One skill, one agent

npx skills add n0an/vivadicta-cli-skills \ --skill vivadicta-transcribe-flow \ --agent claude-code

Preview without installing

npx skills add n0an/vivadicta-cli-skills --list

Pin to a specific version

npx skills add n0an/vivadicta-cli-skills@v1.0.0

Manage installed skills

skills list     # see what's installed
skills update   # refresh to latest
skills remove   # remove a skill

What Ships in the Pack

vivadicta-cli-usage

Reference skill: canonical flags, output formats, env vars, exit codes, TTY behaviour, and a map of every subcommand. The agent loads this when you ask “which flag does X” or need the discovery cheat sheet.

Example trigger: “What vivadicta command lists my last 20 transcriptions as JSON and pipes the titles through jq?”

vivadicta-transcribe-flow

End-to-end workflow for transcribing a local audio file or a YouTube URL into your history. Handles input-shape detection, blocking vs --async, progress output, and error recovery.

Example trigger: “Transcribe ~/Downloads/standup.m4a and give me the result.”

vivadicta-search-and-rewrite

Find a past transcription via natural-language query or the latest keyword, then rewrite it with an AI preset (summary, action points, email, translation, etc.). Resolves ambiguous preset names and surfaces the available preset list.

Example trigger: “Rewrite yesterday's call with Sam as action items.”

vivadicta-vault-export

Export a transcription to Obsidian-ready markdown (YAML frontmatter + body) and pipe it into a vault, daily note, Raycast action, or cron digest.

Example trigger: “Export my last dictation to ~/vault/transcripts as a dated markdown file.”

Why Four Skills, Not One

The split is deliberate, not cosmetic:

  • Progressive disclosure. Agents only load the SKILL.md that matches your intent. One monolithic skill would pull all the instructions into context every turn; four narrow skills keep each turn lean.
  • Triggering precision. “Transcribe an m4a” and “rewrite yesterday's call as action items” are different intents. A merged description would either over-fire on unrelated requests or under-fire on edge phrasings.
  • Reference vs workflow. vivadicta-cli-usage is a lookup cheat sheet; the other three are multi-step playbooks. Mixing those patterns in one file tends to produce a worse-of-both doc.
  • Independent install. Cherry-pick just the skill you need per agent. Useful if you only want the shell helper and not the full workflow set.

Supported Agents

Any stdio AI agent that reads SKILL.md files:

  • Claude Code
  • Claude Desktop (via project instructions)
  • Cursor
  • Codex CLI
  • Gemini CLI
  • Pi
  • Any custom agent that reads the skills format

Versioning

Tagged milestones (v1.0.0, v1.1.0, ...) for users who want to pin. The default branch (main) always reflects the latest guidance; day-to-day edits land without a tag bump. Updating to a new skill-pack version is as lightweight as skills update.

Related

← Command-Line Interface