{"id":51232293,"url":"https://github.com/n0an/vivadicta-cli-skills","last_synced_at":"2026-06-28T17:02:37.495Z","repository":{"id":352681268,"uuid":"1216151462","full_name":"n0an/vivadicta-cli-skills","owner":"n0an","description":"Agent skills for the VivaDicta for Mac CLI (vivadicta). Install with npx skills add n0an/vivadicta-cli-skills.","archived":false,"fork":false,"pushed_at":"2026-04-20T16:45:03.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T18:41:31.591Z","etag":null,"topics":["agent-skills","agents","ai-skills","claude-code","cli","codex","gemini","macos","speech-to-text","vivadicta"],"latest_commit_sha":null,"homepage":"https://vivadicta.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n0an.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T16:08:53.000Z","updated_at":"2026-04-20T16:45:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/n0an/vivadicta-cli-skills","commit_stats":null,"previous_names":["n0an/vivadicta-cli-skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/n0an/vivadicta-cli-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0an%2Fvivadicta-cli-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0an%2Fvivadicta-cli-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0an%2Fvivadicta-cli-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0an%2Fvivadicta-cli-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n0an","download_url":"https://codeload.github.com/n0an/vivadicta-cli-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0an%2Fvivadicta-cli-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34896652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agents","ai-skills","claude-code","cli","codex","gemini","macos","speech-to-text","vivadicta"],"created_at":"2026-06-28T17:02:34.794Z","updated_at":"2026-06-28T17:02:37.489Z","avatar_url":"https://github.com/n0an.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# vivadicta cli skills\n\nAgent skills for [VivaDicta for Mac](https://vivadicta.com)'s command-line interface (`vivadicta`). Drop them into any stdio agent - Claude Code, Cursor, Codex, Goose, Warp etc - so the agent knows when and how to call the CLI for the user's dictation workflows.\n\nOfficial pack maintained alongside the `vivadicta` CLI.\n\n## Installation\n\nInstall the full pack globally (recommended):\n\n```bash\nnpx skills add n0an/vivadicta-cli-skills --global\n```\n\nInstall a single skill for a specific agent:\n\n```bash\nnpx skills add n0an/vivadicta-cli-skills --skill vivadicta-transcribe-flow --agent claude-code\n```\n\nPreview what's in the pack without installing:\n\n```bash\nnpx skills add n0an/vivadicta-cli-skills --list\n```\n\nManage installed skills:\n\n```bash\nskills list             # see what's installed\nskills update           # refresh to latest\nskills remove           # remove a skill\n```\n\nThe pack installs prose-only SKILL.md files; there's no runtime. Updating to a new skill-pack version is as lightweight as `git pull` on a dotfile.\n\n## Prerequisites\n\nBefore these skills are useful, make sure the CLI itself is installed and reachable:\n\n```bash\n# Install the VivaDicta app (notarized DMG) from https://vivadicta.com first, then:\nbrew install n0an/tap/vivadicta\nvivadicta recent 5\n```\n\nWrite skills (`vivadicta-transcribe-flow`, `vivadicta-search-and-rewrite`) also require the VivaDicta UI app to be running, since writes route through a Unix socket into the running app.\n\n## Available Skills\n\n### vivadicta-cli-usage\n\nReference skill: canonical flags, output formats, env vars, exit codes, TTY behavior, and a map of every subcommand.\n\n**Use when:**\n- You need the correct `vivadicta` command, flag, or output format.\n- You need to interpret an exit code or error payload.\n- You want the discovery cheat sheet for the 11 subcommands.\n\n**Example:**\n\n```text\nWhat vivadicta command lists my last 20 transcriptions as JSON and pipes the titles through jq?\n```\n\n### vivadicta-transcribe-flow\n\nEnd-to-end workflow for transcribing a local audio file or a YouTube URL into the user's history. Handles input-shape detection, blocking vs `--async`, progress output, and error recovery.\n\n**Use when:**\n- The user wants to transcribe an audio file (m4a, mp3, wav, etc.).\n- The user wants to transcribe a YouTube URL.\n- You need to decide between blocking and async, or recover from a timed-out / failed transcription.\n\n**Example:**\n\n```text\nTranscribe ~/Downloads/standup.m4a and give me the result.\n```\n\n### vivadicta-search-and-rewrite\n\nFind a past transcription via natural-language query or the `latest` keyword, then rewrite it with an AI preset (summary, action points, email, translation, etc.).\n\n**Use when:**\n- The user wants to turn an existing dictation into action items, an email, a summary, or any other preset output.\n- You need to resolve natural-language queries (\"yesterday's call with sam\") to a specific transcription.\n- The user asks about available presets or gets an ambiguous-preset error.\n\n**Example:**\n\n```text\nRewrite yesterday's call with Sam as action items.\n```\n\n### vivadicta-vault-export\n\nExport a transcription to Obsidian-ready markdown (YAML frontmatter + body) and pipe it into a vault, daily note, Raycast action, or cron digest.\n\n**Use when:**\n- The user wants a dictation record as a markdown file in their Obsidian vault.\n- You need to append a transcript to a daily note or copy it to the clipboard.\n- You're building a shell / Raycast / cron automation that consumes transcripts as markdown.\n\n**Example:**\n\n```text\nExport my last dictation to ~/vault/transcripts as a dated markdown file.\n```\n\n## Versioning\n\nTagged 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.\n\nTo pin to a specific version:\n\n```bash\nnpx skills add n0an/vivadicta-cli-skills@v1.0.0\n```\n\n## Related\n\n- [VivaDicta for Mac](https://vivadicta.com) - the app itself, required for the CLI to do anything meaningful.\n- [n0an/vivadicta-cli](https://github.com/n0an/vivadicta-cli) - the thin bash shim distributed via Homebrew that becomes `vivadicta` on `$PATH`.\n- [n0an/vivadicta-mcp](https://github.com/n0an/vivadicta-mcp) - the parallel shim for the MCP server (`vivadicta-mcp`), a separate install path for MCP clients.\n- [n0an/homebrew-tap](https://github.com/n0an/homebrew-tap) - formula source for both shims.\n\n## License\n\nMIT. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0an%2Fvivadicta-cli-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn0an%2Fvivadicta-cli-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0an%2Fvivadicta-cli-skills/lists"}