{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/voice-notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "linking.md",
      "memory-template.md",
      "processing.md",
      "tags.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/voice-notes",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "When to Use",
        "body": "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."
      },
      {
        "title": "Important: Transcription is Platform-Handled",
        "body": "This skill does NOT perform transcription. It expects the agent platform to:\n\nReceive audio from the user\nTranscribe it using the platform's configured STT (local or cloud)\nPass the transcript text to this skill for organization\n\nThe skill only organizes and stores text transcripts locally in ~/voice-notes/. Audio files are never accessed or stored by this skill."
      },
      {
        "title": "Architecture",
        "body": "All data stored in ~/voice-notes/. See memory-template.md for setup.\n\n~/voice-notes/\n+-- memory.md           # HOT: tag registry + recent activity\n+-- index.md            # Note index with tags and links\n+-- transcripts/        # Raw transcriptions (text only)\n+-- notes/              # Processed notes\n+-- archive/            # Superseded content"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileMemory setupmemory-template.mdNote processingprocessing.mdLinking systemlinking.mdTag managementtags.md"
      },
      {
        "title": "Data Storage",
        "body": "All data stored in ~/voice-notes/. Create on first use:\n\nmkdir -p ~/voice-notes/{transcripts,notes,archive}"
      },
      {
        "title": "Scope",
        "body": "This skill ONLY:\n\nReceives transcript text from the agent platform\nStores transcripts and notes in ~/voice-notes/\nLinks related notes based on content\nManages user-defined tags\n\nThis skill NEVER:\n\nPerforms audio transcription (platform responsibility)\nAccesses audio files\nDeletes content without explicit user confirmation\nAccesses files outside ~/voice-notes/\nSends data externally\nRequires API keys or credentials"
      },
      {
        "title": "Self-Modification",
        "body": "This skill NEVER modifies its own SKILL.md.\nAll data stored in ~/voice-notes/ files."
      },
      {
        "title": "1. Never Lose Information",
        "body": "EventActionNew transcriptSave immediately to transcripts/Edit notePreserve original in transcript referenceStrategy changeArchive old version, link to newUser deletesConfirm first, then move to archive/"
      },
      {
        "title": "2. Tag System Over Folders",
        "body": "Tags defined in ~/voice-notes/memory.md under ## Tag Registry\nUser defines granularity (broad vs specific)\nReuse existing tags before creating new\nEach note can have multiple tags"
      },
      {
        "title": "3. Detect Related Content",
        "body": "Before creating new note:\n\nSearch existing notes for topic overlap\nIf related -> append or link (not duplicate)\nIf continuation -> extend existing note\nIf contradicts -> link as evolution, preserve both"
      },
      {
        "title": "4. Document Scaling",
        "body": "When note exceeds ~100 lines:\n\nIdentify natural sections\nSplit into linked child notes\nParent becomes overview with links\nLike Notion: notes contain notes"
      },
      {
        "title": "5. Progressive Disclosure",
        "body": "TierWhen Loaded~/voice-notes/memory.mdAlways (tags, recent)~/voice-notes/index.mdWhen searchingIndividual notesOn demandTranscriptsFor verification only"
      },
      {
        "title": "6. Reorganize Chaotic Input",
        "body": "User may speak stream-of-consciousness:\n\nExtract clear meaning\nStructure logically\nPreserve nuance (not over-condense)\nGroup related points"
      },
      {
        "title": "7. First Session Setup",
        "body": "Ask user on first use:\n\n\"Broad categories or detailed tags?\"\n\"Any existing topics to seed?\""
      },
      {
        "title": "Common Traps",
        "body": "Creating new note when should append -> always search first\nLosing tag consistency -> check registry before creating tags\nOver-condensing -> preserve user's intent and nuance\nDeleting \"outdated\" content -> archive, never delete"
      }
    ],
    "body": "When to Use\n\nUser 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.\n\nImportant: Transcription is Platform-Handled\n\nThis skill does NOT perform transcription. It expects the agent platform to:\n\nReceive audio from the user\nTranscribe it using the platform's configured STT (local or cloud)\nPass the transcript text to this skill for organization\n\nThe skill only organizes and stores text transcripts locally in ~/voice-notes/. Audio files are never accessed or stored by this skill.\n\nArchitecture\n\nAll data stored in ~/voice-notes/. See memory-template.md for setup.\n\n~/voice-notes/\n+-- memory.md           # HOT: tag registry + recent activity\n+-- index.md            # Note index with tags and links\n+-- transcripts/        # Raw transcriptions (text only)\n+-- notes/              # Processed notes\n+-- archive/            # Superseded content\n\nQuick Reference\nTopic\tFile\nMemory setup\tmemory-template.md\nNote processing\tprocessing.md\nLinking system\tlinking.md\nTag management\ttags.md\nData Storage\n\nAll data stored in ~/voice-notes/. Create on first use:\n\nmkdir -p ~/voice-notes/{transcripts,notes,archive}\n\nScope\n\nThis skill ONLY:\n\nReceives transcript text from the agent platform\nStores transcripts and notes in ~/voice-notes/\nLinks related notes based on content\nManages user-defined tags\n\nThis skill NEVER:\n\nPerforms audio transcription (platform responsibility)\nAccesses audio files\nDeletes content without explicit user confirmation\nAccesses files outside ~/voice-notes/\nSends data externally\nRequires API keys or credentials\nSelf-Modification\n\nThis skill NEVER modifies its own SKILL.md. All data stored in ~/voice-notes/ files.\n\nCore Rules\n1. Never Lose Information\nEvent\tAction\nNew transcript\tSave immediately to transcripts/\nEdit note\tPreserve original in transcript reference\nStrategy change\tArchive old version, link to new\nUser deletes\tConfirm first, then move to archive/\n2. Tag System Over Folders\nTags defined in ~/voice-notes/memory.md under ## Tag Registry\nUser defines granularity (broad vs specific)\nReuse existing tags before creating new\nEach note can have multiple tags\n3. Detect Related Content\n\nBefore creating new note:\n\nSearch existing notes for topic overlap\nIf related -> append or link (not duplicate)\nIf continuation -> extend existing note\nIf contradicts -> link as evolution, preserve both\n4. Document Scaling\n\nWhen note exceeds ~100 lines:\n\nIdentify natural sections\nSplit into linked child notes\nParent becomes overview with links\nLike Notion: notes contain notes\n5. Progressive Disclosure\nTier\tWhen Loaded\n~/voice-notes/memory.md\tAlways (tags, recent)\n~/voice-notes/index.md\tWhen searching\nIndividual notes\tOn demand\nTranscripts\tFor verification only\n6. Reorganize Chaotic Input\n\nUser may speak stream-of-consciousness:\n\nExtract clear meaning\nStructure logically\nPreserve nuance (not over-condense)\nGroup related points\n7. First Session Setup\n\nAsk user on first use:\n\n\"Broad categories or detailed tags?\"\n\"Any existing topics to seed?\"\nCommon Traps\nCreating new note when should append -> always search first\nLosing tag consistency -> check registry before creating tags\nOver-condensing -> preserve user's intent and nuance\nDeleting \"outdated\" content -> archive, never delete"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/voice-notes",
    "publisherUrl": "https://clawhub.ai/ivangdavila/voice-notes",
    "owner": "ivangdavila",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}