Voice Notes

Organize voice message transcripts into a structured, searchable knowledge base with tags, links, and progressive note-taking.

Security Scan

The skill's requested actions (organizing transcript text under ~/voice-notes) match its description and there are no unexplained credentials, installs, or external endpoints in the provided instructions.

Purpose & Capability

Name/description (organize transcripts into notes/tags) aligns with the runtime instructions: creating and managing Markdown files under ~/voice-notes/, indexing, tagging and linking. No unrelated credentials, binaries, or installs are requested.

Instruction Scope

SKILL.md and supporting docs restrict all file access to ~/voice-notes/ and state that transcription and audio handling are platform responsibilities. This is coherent, but the skill assumes the platform will pass transcript text; transcripts may contain sensitive data and are read/written by the skill, so confirm the agent/platform's transcript handling and retention policies before use.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is downloaded or written by an installer. Lowest-risk installation posture for this type of skill.

Credentials

No environment variables, credentials, or external API keys are requested. The only resource requested is a directory under the user's home (~/voice-notes/), which is reasonable for local note storage.

Persistence & Privilege

always is false (default). The skill does not claim to modify other skills or system settings and promises not to modify its SKILL.md. Its persistence is limited to files in ~/voice-notes/.

Scan Findings in Context

[no_regex_findings] expected: Scanner found nothing to analyze because this is an instruction-only skill with no code files — this is expected for a documentation-only skill.

Assessment

This skill is internally consistent: it only organizes transcript text into files under ~/voice-notes/ and requires no credentials. Before installing, confirm the agent/platform will (a) perform transcription and pass text rather than raw audio, (b) not send transcripts to external services unless you expect that, and (c) apply appropriate file permissions or encryption for ~/voice-notes/ if transcripts contain sensitive information. Also verify the platform prompts you before deletion (the skill says it will confirm) and check how the platform itself stores/transmits transcripts — the skill's safety depends on the agent/platform behavior as well.

When to Use

User sends voice messages. The agent platform handles transcription (via its configured STT). This skill organizes the resulting transcripts into structured notes, links related content, and maintains a scalable tag-based system.

Important: Transcription is Platform-Handled

This skill does NOT perform transcription. It expects the agent platform to:

1. Receive audio from the user
2. Transcribe it using the platform's configured STT (local or cloud)
3. Pass the transcript text to this skill for organization

The skill only organizes and stores text transcripts locally in ~/voice-notes/. Audio files are never accessed or stored by this skill.

Architecture

All data stored in ~/voice-notes/. See memory-template.md for setup.

~/voice-notes/
+-- memory.md           # HOT: tag registry + recent activity
+-- index.md            # Note index with tags and links
+-- transcripts/        # Raw transcriptions (text only)
+-- notes/              # Processed notes
+-- archive/            # Superseded content

Quick Reference

Topic	File
Memory setup	memory-template.md
Note processing	processing.md
Linking system	linking.md
Tag management	tags.md

Data Storage

All data stored in ~/voice-notes/. Create on first use:

mkdir -p ~/voice-notes/{transcripts,notes,archive}

Scope

This skill ONLY:

• Receives transcript text from the agent platform
• Stores transcripts and notes in ~/voice-notes/
• Links related notes based on content
• Manages user-defined tags

This skill NEVER:

• Performs audio transcription (platform responsibility)
• Accesses audio files
• Deletes content without explicit user confirmation
• Accesses files outside ~/voice-notes/
• Sends data externally
• Requires API keys or credentials

Self-Modification

This skill NEVER modifies its own SKILL.md. All data stored in ~/voice-notes/ files.

Core Rules

1. Never Lose Information

Event	Action
New transcript	Save immediately to transcripts/
Edit note	Preserve original in transcript reference
Strategy change	Archive old version, link to new
User deletes	Confirm first, then move to archive/

2. Tag System Over Folders

• Tags defined in ~/voice-notes/memory.md under ## Tag Registry
• User defines granularity (broad vs specific)
• Reuse existing tags before creating new
• Each note can have multiple tags

3. Detect Related Content

Before creating new note:

1. Search existing notes for topic overlap
2. If related -> append or link (not duplicate)
3. If continuation -> extend existing note
4. If contradicts -> link as evolution, preserve both

4. Document Scaling

When note exceeds ~100 lines:

1. Identify natural sections
2. Split into linked child notes
3. Parent becomes overview with links
4. Like Notion: notes contain notes

5. Progressive Disclosure

Tier	When Loaded
~/voice-notes/memory.md	Always (tags, recent)
~/voice-notes/index.md	When searching
Individual notes	On demand
Transcripts	For verification only

6. Reorganize Chaotic Input

User may speak stream-of-consciousness:

• Extract clear meaning
• Structure logically
• Preserve nuance (not over-condense)
• Group related points

7. First Session Setup

Ask user on first use:

• "Broad categories or detailed tags?"
• "Any existing topics to seed?"

Common Traps

• Creating new note when should append -> always search first
• Losing tag consistency -> check registry before creating tags
• Over-condensing -> preserve user's intent and nuance
• Deleting "outdated" content -> archive, never delete