# Send Voice Notes to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "voice-notes",
    "name": "Voice Notes",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/voice-notes",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/voice-notes",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/voice-notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "linking.md",
      "memory-template.md",
      "processing.md",
      "tags.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "voice-notes",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T17:41:32.164Z",
      "expiresAt": "2026-05-17T17:41:32.164Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-notes",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-notes",
        "contentDisposition": "attachment; filename=\"voice-notes-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "voice-notes"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/voice-notes"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/voice-notes",
    "downloadUrl": "https://openagent3.xyz/downloads/voice-notes",
    "agentUrl": "https://openagent3.xyz/skills/voice-notes/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voice-notes/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voice-notes/agent.md"
  }
}
```
## Documentation

### 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:

Receive audio from the user
Transcribe it using the platform's configured STT (local or cloud)
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

TopicFileMemory setupmemory-template.mdNote processingprocessing.mdLinking systemlinking.mdTag managementtags.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.

### 1. Never Lose Information

EventActionNew transcriptSave immediately to transcripts/Edit notePreserve original in transcript referenceStrategy changeArchive old version, link to newUser deletesConfirm 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:

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

### 4. Document Scaling

When note exceeds ~100 lines:

Identify natural sections
Split into linked child notes
Parent becomes overview with links
Like Notion: notes contain notes

### 5. Progressive Disclosure

TierWhen Loaded~/voice-notes/memory.mdAlways (tags, recent)~/voice-notes/index.mdWhen searchingIndividual notesOn demandTranscriptsFor 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T17:41:32.164Z
- Expires at: 2026-05-17T17:41:32.164Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/voice-notes)
- [Send to Agent page](https://openagent3.xyz/skills/voice-notes/agent)
- [JSON manifest](https://openagent3.xyz/skills/voice-notes/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/voice-notes/agent.md)
- [Download page](https://openagent3.xyz/downloads/voice-notes)