# Send Suno 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": "suno",
    "name": "Suno",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/suno",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/suno",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/suno",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=suno",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "EXTRA_FILES.txt",
      "MIGRATION_CHECK.json",
      "PERCEPTION_EVAL_TODO.md",
      "PERCEPTION_RESULT.json",
      "SIMULATION.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "suno",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T13:50:27.038Z",
      "expiresAt": "2026-05-16T13:50:27.038Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=suno",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=suno",
        "contentDisposition": "attachment; filename=\"suno-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "suno"
      },
      "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/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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for integration guidelines.

### When to Use

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.

### Architecture

Memory at ~/suno/. See memory-template.md for structure.

~/suno/
├── [memory.md]       # Created on first use: preferences, successful prompts
├── [projects/]       # Per-project song tracking
└── [songs/]          # Downloaded audio files

### Quick Reference

TopicFileSetupsetup.mdMemorymemory-template.mdAPI usageapi.mdBrowser automationbrowser.mdPrompt craftingprompts.mdStyle tagsstyles.mdLyrics guidelyrics.md

### 1. Choose the Right Approach

SituationMethodProgrammatic generationHosted API (aimusicapi.ai, EvoLink)Visual interactionBrowser at suno.comJust need promptsPrompt engineering only

### 2. Structure Prompts in Layers

[genre] [subgenre] [mood] [instruments] [voice] [era/influence]

Example: "indie folk melancholic acoustic guitar soft female vocals 90s"

### 3. Custom Lyrics Format

[Verse]
Your lyrics here

[Chorus]
Hook section

[Bridge]
Contrast

[Outro]
Ending

### 4. Extend Songs Strategically

Suno generates clips. Build full songs:

Create initial clip with strong hook
Extend with consistent style
Add outro with ending indicators
Target 2-4 minutes total

### 5. API Usage Pattern

All APIs follow: generate → poll for completion → retrieve audio URL.
Generation takes 30-90 seconds. See api.md for code examples.

### Hosted APIs (Recommended)

Two main options for programmatic generation:

aimusicapi.ai — Get API key at aimusicapi.ai
EvoLink — Get API key at evolink.ai

Both provide REST APIs for generation, custom lyrics, and extensions.
See api.md for detailed code examples and endpoint documentation.

### API Flow

# Conceptual flow (see api.md for real code)
1. POST /generate with prompt
2. Receive task_id
3. Poll /task/{id} every 5 seconds
4. Get audio_url when status="completed"

### Browser Automation

When API isn't available or user prefers visual interaction:

### Generate at suno.com

Navigate to suno.com/create
Choose Simple (description) or Custom (lyrics + style)
Enter prompt or lyrics
Click Create, wait 30-60 seconds
Download the audio

See browser.md for detailed automation steps.

### By Genre

GenrePatternElectronicelectronic [subgenre] [mood] synth [texture]Rock[sub]rock [energy] [guitars] [vocals] [decade]Poppop [mood] [tempo] [vocals] [production]Hip Hophip hop [subgenre] [beat] [flow] [era]

### Voice Control

soft female vocals, ethereal, breathy
deep male vocals, baritone, raspy
instrumental, no vocals

See prompts.md and styles.md for comprehensive guides.

### Common Traps

TrapProblemSolutionVague promptsRandom outputBe specific with genre, moodContradictionsConfuses modelConsistent descriptorsToo many keywordsDilutes focus8-12 key terms maxNo structure tagsAwkward lyricsUse [Verse], [Chorus]

### Data Storage

This skill creates ~/suno/ on first use:

memory file — Preferences, successful prompts
projects folder — Per-project tracking
songs folder — Downloaded audio (optional)

All data stays local. API keys should be stored as environment variables.

### Scope

This skill does:

Generate music via hosted APIs (requires API key from provider)
Navigate suno.com with browser automation
Craft optimized prompts for Suno's model
Write lyrics with proper structure tags
Track projects and successful patterns locally

This skill does NOT:

Store API keys in plain text files
Access files outside ~/suno/
Make requests without user direction

### External Endpoints

When using hosted APIs, requests go to:

EndpointData SentPurposeapi.aimusicapi.aiPrompts, lyricsMusic generationapi.evolink.aiPrompts, lyricsMusic generationsuno.comBrowser sessionDirect platform access

API keys authenticate requests. Prompts and lyrics are sent for processing.

### Trust

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.

### Related Skills

Install with clawhub install <slug> if user confirms:

audio — Audio processing and editing
video — Combine music with video content
ffmpeg — Audio format conversion

### Feedback

If useful: clawhub star suno
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## 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-09T13:50:27.038Z
- Expires at: 2026-05-16T13:50:27.038Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/suno)
- [Send to Agent page](https://openagent3.xyz/skills/suno/agent)
- [JSON manifest](https://openagent3.xyz/skills/suno/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/suno/agent.md)
- [Download page](https://openagent3.xyz/downloads/suno)