{
  "schemaVersion": "1.0",
  "item": {
    "slug": "suno",
    "name": "Suno",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/suno",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/suno",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/suno",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=suno",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "EXTRA_FILES.txt",
      "MIGRATION_CHECK.json",
      "PERCEPTION_EVAL_TODO.md",
      "PERCEPTION_RESULT.json",
      "SIMULATION.md",
      "SKILL.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/suno"
    },
    "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/suno",
    "agentPageUrl": "https://openagent3.xyz/skills/suno/agent",
    "manifestUrl": "https://openagent3.xyz/skills/suno/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/suno/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": "Setup",
        "body": "On first use, read setup.md for integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "User wants to generate music with Suno. Agent can use hosted APIs for programmatic generation, browser automation for direct platform interaction, or guide prompt engineering for manual use."
      },
      {
        "title": "Architecture",
        "body": "Memory at ~/suno/. See memory-template.md for structure.\n\n~/suno/\n├── [memory.md]       # Created on first use: preferences, successful prompts\n├── [projects/]       # Per-project song tracking\n└── [songs/]          # Downloaded audio files"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetupsetup.mdMemorymemory-template.mdAPI usageapi.mdBrowser automationbrowser.mdPrompt craftingprompts.mdStyle tagsstyles.mdLyrics guidelyrics.md"
      },
      {
        "title": "1. Choose the Right Approach",
        "body": "SituationMethodProgrammatic generationHosted API (aimusicapi.ai, EvoLink)Visual interactionBrowser at suno.comJust need promptsPrompt engineering only"
      },
      {
        "title": "2. Structure Prompts in Layers",
        "body": "[genre] [subgenre] [mood] [instruments] [voice] [era/influence]\n\nExample: \"indie folk melancholic acoustic guitar soft female vocals 90s\""
      },
      {
        "title": "3. Custom Lyrics Format",
        "body": "[Verse]\nYour lyrics here\n\n[Chorus]\nHook section\n\n[Bridge]\nContrast\n\n[Outro]\nEnding"
      },
      {
        "title": "4. Extend Songs Strategically",
        "body": "Suno generates clips. Build full songs:\n\nCreate initial clip with strong hook\nExtend with consistent style\nAdd outro with ending indicators\nTarget 2-4 minutes total"
      },
      {
        "title": "5. API Usage Pattern",
        "body": "All APIs follow: generate → poll for completion → retrieve audio URL.\nGeneration takes 30-90 seconds. See api.md for code examples."
      },
      {
        "title": "Hosted APIs (Recommended)",
        "body": "Two main options for programmatic generation:\n\naimusicapi.ai — Get API key at aimusicapi.ai\nEvoLink — Get API key at evolink.ai\n\nBoth provide REST APIs for generation, custom lyrics, and extensions.\nSee api.md for detailed code examples and endpoint documentation."
      },
      {
        "title": "API Flow",
        "body": "# Conceptual flow (see api.md for real code)\n1. POST /generate with prompt\n2. Receive task_id\n3. Poll /task/{id} every 5 seconds\n4. Get audio_url when status=\"completed\""
      },
      {
        "title": "Browser Automation",
        "body": "When API isn't available or user prefers visual interaction:"
      },
      {
        "title": "Generate at suno.com",
        "body": "Navigate to suno.com/create\nChoose Simple (description) or Custom (lyrics + style)\nEnter prompt or lyrics\nClick Create, wait 30-60 seconds\nDownload the audio\n\nSee browser.md for detailed automation steps."
      },
      {
        "title": "By Genre",
        "body": "GenrePatternElectronicelectronic [subgenre] [mood] synth [texture]Rock[sub]rock [energy] [guitars] [vocals] [decade]Poppop [mood] [tempo] [vocals] [production]Hip Hophip hop [subgenre] [beat] [flow] [era]"
      },
      {
        "title": "Voice Control",
        "body": "soft female vocals, ethereal, breathy\ndeep male vocals, baritone, raspy\ninstrumental, no vocals\n\nSee prompts.md and styles.md for comprehensive guides."
      },
      {
        "title": "Common Traps",
        "body": "TrapProblemSolutionVague promptsRandom outputBe specific with genre, moodContradictionsConfuses modelConsistent descriptorsToo many keywordsDilutes focus8-12 key terms maxNo structure tagsAwkward lyricsUse [Verse], [Chorus]"
      },
      {
        "title": "Data Storage",
        "body": "This skill creates ~/suno/ on first use:\n\nmemory file — Preferences, successful prompts\nprojects folder — Per-project tracking\nsongs folder — Downloaded audio (optional)\n\nAll data stays local. API keys should be stored as environment variables."
      },
      {
        "title": "Scope",
        "body": "This skill does:\n\nGenerate music via hosted APIs (requires API key from provider)\nNavigate suno.com with browser automation\nCraft optimized prompts for Suno's model\nWrite lyrics with proper structure tags\nTrack projects and successful patterns locally\n\nThis skill does NOT:\n\nStore API keys in plain text files\nAccess files outside ~/suno/\nMake requests without user direction"
      },
      {
        "title": "External Endpoints",
        "body": "When using hosted APIs, requests go to:\n\nEndpointData SentPurposeapi.aimusicapi.aiPrompts, lyricsMusic generationapi.evolink.aiPrompts, lyricsMusic generationsuno.comBrowser sessionDirect platform access\n\nAPI keys authenticate requests. Prompts and lyrics are sent for processing."
      },
      {
        "title": "Trust",
        "body": "By using this skill with APIs, prompts and lyrics are sent to third-party services for music generation. Only use services you trust with your creative content."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\naudio — Audio processing and editing\nvideo — Combine music with video content\nffmpeg — Audio format conversion"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star suno\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser wants to generate music with Suno. Agent can use hosted APIs for programmatic generation, browser automation for direct platform interaction, or guide prompt engineering for manual use.\n\nArchitecture\n\nMemory at ~/suno/. See memory-template.md for structure.\n\n~/suno/\n├── [memory.md]       # Created on first use: preferences, successful prompts\n├── [projects/]       # Per-project song tracking\n└── [songs/]          # Downloaded audio files\n\nQuick Reference\nTopic\tFile\nSetup\tsetup.md\nMemory\tmemory-template.md\nAPI usage\tapi.md\nBrowser automation\tbrowser.md\nPrompt crafting\tprompts.md\nStyle tags\tstyles.md\nLyrics guide\tlyrics.md\nCore Rules\n1. Choose the Right Approach\nSituation\tMethod\nProgrammatic generation\tHosted API (aimusicapi.ai, EvoLink)\nVisual interaction\tBrowser at suno.com\nJust need prompts\tPrompt engineering only\n2. Structure Prompts in Layers\n[genre] [subgenre] [mood] [instruments] [voice] [era/influence]\n\n\nExample: \"indie folk melancholic acoustic guitar soft female vocals 90s\"\n\n3. Custom Lyrics Format\n[Verse]\nYour lyrics here\n\n[Chorus]\nHook section\n\n[Bridge]\nContrast\n\n[Outro]\nEnding\n\n4. Extend Songs Strategically\n\nSuno generates clips. Build full songs:\n\nCreate initial clip with strong hook\nExtend with consistent style\nAdd outro with ending indicators\nTarget 2-4 minutes total\n5. API Usage Pattern\n\nAll APIs follow: generate → poll for completion → retrieve audio URL. Generation takes 30-90 seconds. See api.md for code examples.\n\nAPI Integration\nHosted APIs (Recommended)\n\nTwo main options for programmatic generation:\n\naimusicapi.ai — Get API key at aimusicapi.ai EvoLink — Get API key at evolink.ai\n\nBoth provide REST APIs for generation, custom lyrics, and extensions. See api.md for detailed code examples and endpoint documentation.\n\nAPI Flow\n# Conceptual flow (see api.md for real code)\n1. POST /generate with prompt\n2. Receive task_id\n3. Poll /task/{id} every 5 seconds\n4. Get audio_url when status=\"completed\"\n\nBrowser Automation\n\nWhen API isn't available or user prefers visual interaction:\n\nGenerate at suno.com\nNavigate to suno.com/create\nChoose Simple (description) or Custom (lyrics + style)\nEnter prompt or lyrics\nClick Create, wait 30-60 seconds\nDownload the audio\n\nSee browser.md for detailed automation steps.\n\nPrompt Patterns\nBy Genre\nGenre\tPattern\nElectronic\telectronic [subgenre] [mood] synth [texture]\nRock\t[sub]rock [energy] [guitars] [vocals] [decade]\nPop\tpop [mood] [tempo] [vocals] [production]\nHip Hop\thip hop [subgenre] [beat] [flow] [era]\nVoice Control\nsoft female vocals, ethereal, breathy\ndeep male vocals, baritone, raspy\ninstrumental, no vocals\n\n\nSee prompts.md and styles.md for comprehensive guides.\n\nCommon Traps\nTrap\tProblem\tSolution\nVague prompts\tRandom output\tBe specific with genre, mood\nContradictions\tConfuses model\tConsistent descriptors\nToo many keywords\tDilutes focus\t8-12 key terms max\nNo structure tags\tAwkward lyrics\tUse [Verse], [Chorus]\nData Storage\n\nThis skill creates ~/suno/ on first use:\n\nmemory file — Preferences, successful prompts\nprojects folder — Per-project tracking\nsongs folder — Downloaded audio (optional)\n\nAll data stays local. API keys should be stored as environment variables.\n\nScope\n\nThis skill does:\n\nGenerate music via hosted APIs (requires API key from provider)\nNavigate suno.com with browser automation\nCraft optimized prompts for Suno's model\nWrite lyrics with proper structure tags\nTrack projects and successful patterns locally\n\nThis skill does NOT:\n\nStore API keys in plain text files\nAccess files outside ~/suno/\nMake requests without user direction\nExternal Endpoints\n\nWhen using hosted APIs, requests go to:\n\nEndpoint\tData Sent\tPurpose\napi.aimusicapi.ai\tPrompts, lyrics\tMusic generation\napi.evolink.ai\tPrompts, lyrics\tMusic generation\nsuno.com\tBrowser session\tDirect platform access\n\nAPI keys authenticate requests. Prompts and lyrics are sent for processing.\n\nTrust\n\nBy using this skill with APIs, prompts and lyrics are sent to third-party services for music generation. Only use services you trust with your creative content.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\naudio — Audio processing and editing\nvideo — Combine music with video content\nffmpeg — Audio format conversion\nFeedback\nIf useful: clawhub star suno\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/suno",
    "publisherUrl": "https://clawhub.ai/ivangdavila/suno",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/suno",
    "downloadUrl": "https://openagent3.xyz/downloads/suno",
    "agentUrl": "https://openagent3.xyz/skills/suno/agent",
    "manifestUrl": "https://openagent3.xyz/skills/suno/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/suno/agent.md"
  }
}