Vivadicta vault export

Skill n0an/vivadicta-cli-skills/skills/vivadicta-vault-export

Agent skills for the VivaDicta for Mac CLI (vivadicta). Install with npx skills add n0an/vivadicta-cli-skills.

Install

npx -y skills add n0an/vivadicta-cli-skills --skill vivadicta-vault-export

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Export a transcription to Obsidian-ready markdown with YAML frontmatter using vivadicta get --output markdown. Use when the user wants a dictation record as a markdown file in their vault or any shell pipeline expecting markdown.

SKILL.md

4.6 KB, as published. Nobody here has run it

vivadicta vault export

Use this skill to write a VivaDicta transcription into a markdown file suitable for an Obsidian vault, a daily note, a blog draft, or any pipeline that consumes markdown.

Preconditions

VivaDicta.app installed at /Applications/VivaDicta.app. UI app does not need to be running - get is a read command.
The target transcription exists in history. If the user said "today's dictation", confirm with vivadicta recent 1 first.

The one flag that matters

--output markdown on get produces YAML frontmatter + body. This is the Obsidian-ready form. Other subcommands don't support markdown output.

vivadicta get latest --output markdown

Output shape (stdout):

---
title: "Call with Sam about the sprint plan"
date: 2026-04-18T14:32:00Z
duration_seconds: 522
duration_display: "08:42"
source: "Mac"
viva_mode: "Coding"
tags: ["sprint-planning", "work"]
transcription_model: "parakeet-tdt-0.6b-v3"
---

# Raw transcript

...full transcript text...

# Latest enhancement (Action Points)

...enhanced text if present...

The frontmatter keys are stable and Obsidian-friendly (quotable strings, ISO dates, arrays).

Common patterns

Save today's dictation into a dated file:

vivadicta get latest --output markdown > ~/vault/transcripts/$(date +%F).md

Save a specific transcription by query:

vivadicta get "yesterday's call with sam" --output markdown > ~/vault/calls/sam-$(date +%F).md

Include every AI variation (Summary, Action Points, Email, …) as separate sections in the body:

vivadicta get <uuid> --output markdown --all-variations > ~/vault/notes/$(date +%F).md

Pipe to pbcopy for a quick paste into an existing note:

vivadicta get latest --output markdown | pbcopy

Append to a daily note (Obsidian Daily Notes plugin format):

vivadicta get latest --output markdown >> ~/vault/daily/$(date +%F).md

Identifier forms

Same three shapes as vivadicta-search-and-rewrite:

Keyword: latest, last, most recent, newest, current
Natural-language query: "yesterday's call with sam"
Raw UUID

When the user says "my last meeting", prefer latest. When they describe it, use a natural-language query. When they already have a UUID, pass it through.

Chain with transcribe or rewrite

Transcribe then export:

vivadicta transcribe ~/Downloads/meeting.m4a
vivadicta get latest --output markdown > ~/vault/transcripts/$(date +%F).md

Rewrite then export (includes both original + rewritten variation):

UUID=$(vivadicta recent 1 --output json | jq -r '.transcriptions[0].ref')
vivadicta rewrite "$UUID" --preset summary > /dev/null
vivadicta get "$UUID" --output markdown --all-variations > ~/vault/notes/summary.md

Automation hooks

Raycast script command (copy daily summary to clipboard):

#!/bin/bash
# @raycast.title Copy latest VivaDicta transcript
# @raycast.mode silent
vivadicta get latest --output markdown | pbcopy

Nightly cron digest - export every transcription from the last 24 h:

#!/bin/bash
for uuid in $(vivadicta search "" --since "24 hours ago" --output json | jq -r '.transcriptions[].ref'); do
  vivadicta get "$uuid" --output markdown > ~/vault/transcripts/"$uuid.md"
done

Quick shell alias for a common destination:

alias viva-to-vault='vivadicta get latest --output markdown > ~/vault/transcripts/$(date +%F).md'

Guardrails

--output markdown only works on get. Don't try it on recent, search, etc. - they error with invalid_arguments (exit 2).
The body's "Latest enhancement" section appears only if the transcription has an enhancedText. Use --all-variations to include every saved variation explicitly.
Overwriting vs appending: > overwrites, >> appends. Ask the user which they want if it's ambiguous (dated filenames are usually fine to overwrite within the same day; daily notes typically want >>).
Tags in the frontmatter come from the user's tag system inside VivaDicta. They match what vivadicta tags shows and what Obsidian will pick up as tags automatically.
Date in the frontmatter is ISO 8601 UTC. If the user wants local time, they'll need to transform it in the Obsidian template.

See vivadicta-cli-usage for output-format rules. See vivadicta-search-and-rewrite for producing the rewritten content before exporting.