psycho-baller/letterly-automation
skills/letterly-automation/SKILL.md
Full Letterly pipeline - export CSV, process magic notes into Obsidian markdown, semantically link them, and move to Transcriptions. Use when syncing or importing new Letterly magic notes.
tools
Updated May 21, 2026
$ install --global
skillsauthnpx skillsauth add psycho-baller/ai-agents-config letterly-automationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 5:40 AM187.6s3 files scanned
SKILL.md
- name:
- letterly-automation
- version:
- 1.2.0
- description:
- Full Letterly pipeline - export CSV, process magic notes into Obsidian markdown, semantically link them, and move to Transcriptions. Use when syncing or importing new Letterly magic notes.
Letterly Automation
This skill provides a complete workflow for importing and processing your voice transcriptions from Letterly into your Obsidian vault.
Workflow Summary
This master skill orchestrates the following independent sub-skills:
letterly-export: Uses a Playwright browser agent to log in and download the latest CSV export fromweb.letterly.app.letterly-process: Extracts only notes marked as "magic" in the CSV, creates markdown files with custom frontmatter, preserves the CSVtagscolumn asletterly_tags, and places them inunprocessed/.generate-metadata: Agent-driven step that reads each new transcription, usesletterly_tagsas source context when present, generates structured top-level frontmatter metadata, and uses the Python validator/merger to enforce the schema.obsidian-semantic-linker: Analyzes metadata-ready notes and links them to existing vault content using the local semantic embedding database (.smart-env/).- Deliver: Moves notes with valid generated metadata to
My Outputs/Transcriptions/and leaves notes with missing or invalid metadata inunprocessed/.
Metadata Gate
Delivery is based on valid generated metadata, not on the presence of ## Related Notes.
The automation script can validate metadata, but it cannot generate semantic metadata by itself because no AI API is called from Python. When running this as an agent workflow, run the generate-metadata skill after letterly-process creates markdown files and before semantic linking/delivery.
Letterly tags are preserved before this gate as letterly_tags in frontmatter. They are context for the agent-generated metadata, not part of the validator-managed metadata schema.
Usage
To trigger the full workflow, simply tell the model: "Process new Letterly transcriptions" or "Sync my Letterly magic notes".
Manual Execution
If you need to run it manually from the terminal:
# Setup (First time only)
uv venv .venv --python 3.12
uv pip install -r scripts/requirements.txt
.venv/bin/playwright install chromium
# Run
.venv/bin/python scripts/workflow.py
For the agent-driven metadata workflow, use the two-phase mode:
# 1. Export/process Letterly notes into unprocessed/
.venv/bin/python scripts/workflow.py --mode prepare
# 2. Run generate-metadata on the listed files
# 3. Validate/link/deliver metadata-ready notes
.venv/bin/python scripts/workflow.py --mode finish
--mode full is still available, but it can only deliver files that already have valid generated metadata.
Troubleshooting
- Login Timeout: If the script times out waiting for login, ensure you have the browser window visible and log in within the 120-second window.
- Database Missing: Ensure you are running this from your Obsidian vault root where
.smart-env/exists. - No Magic Notes: The script only imports notes that have been processed with the "Magic" rewrite type in Letterly.
- Metadata Missing: Notes without valid generated metadata stay in
unprocessed/instead of moving toMy Outputs/Transcriptions/.
Related Skills
psycho-baller/task-framing
tools
VerifiedTrustedCommunity
Pre-task clarity ritual for Rami. Surfaces real intention, maps work to his pillars, and produces a Session Brief. Use when Rami is about to start a task or plan a work session.
SKILL.mdUpdated May 21, 2026
psycho-baller/obsidian-search
testing
VerifiedTrustedCommunity
Find and retrieve notes from Rami's Obsidian vault by topic or theme using semantic search against Smart Connections embeddings. Use when asked to find notes about a specific subject, retrieve relevant vault content, or surface what Rami has written about a topic.
SKILL.mdUpdated May 21, 2026
psycho-baller/update-patterns
testing
VerifiedTrustedCommunity
Update living Obsidian pattern files from metadata-enriched transcriptions. Use when asked to populate or update pattern files for communication flaws, beliefs, fears, principles, or people/projects mentioned.
SKILL.mdUpdated May 2, 2026
psycho-baller/generate-principles
testing
VerifiedTrustedCommunity
Generate evidence-backed personal principles from markdown notes, reflections, and transcripts. Use when extracting life principles, decision rules, or lessons from journal entries and reflections.
SKILL.mdUpdated May 2, 2026