{
  "schemaVersion": "1.0",
  "item": {
    "slug": "acestep-songwriting",
    "name": "acestep-songwriting",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/DumoeDss/acestep-songwriting",
    "canonicalUrl": "https://clawhub.ai/DumoeDss/acestep-songwriting",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/acestep-songwriting",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=acestep-songwriting",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/acestep-songwriting"
    },
    "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/acestep-songwriting",
    "agentPageUrl": "https://openagent3.xyz/skills/acestep-songwriting/agent",
    "manifestUrl": "https://openagent3.xyz/skills/acestep-songwriting/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/acestep-songwriting/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": "ACE-Step Songwriting Guide",
        "body": "Professional music creation knowledge for writing captions, lyrics, and choosing music parameters for ACE-Step."
      },
      {
        "title": "Output Format",
        "body": "After using this guide, produce two things for the acestep skill:\n\nCaption (-c): Style/genre/instruments/emotion description\nLyrics (-l): Complete structured lyrics with tags\nParameters: --duration, --bpm, --key, --time-signature, --language"
      },
      {
        "title": "Caption: The Most Important Input",
        "body": "Caption is the most important factor affecting generated music.\n\nSupports multiple formats: simple style words, comma-separated tags, complex natural language descriptions."
      },
      {
        "title": "Common Dimensions",
        "body": "DimensionExamplesStyle/Genrepop, rock, jazz, electronic, hip-hop, R&B, folk, classical, lo-fi, synthwaveEmotion/Atmospheremelancholic, uplifting, energetic, dreamy, dark, nostalgic, euphoric, intimateInstrumentsacoustic guitar, piano, synth pads, 808 drums, strings, brass, electric bassTimbre Texturewarm, bright, crisp, muddy, airy, punchy, lush, raw, polishedEra Reference80s synth-pop, 90s grunge, 2010s EDM, vintage soul, modern trapProduction Stylelo-fi, high-fidelity, live recording, studio-polished, bedroom popVocal Characteristicsfemale vocal, male vocal, breathy, powerful, falsetto, raspy, choirSpeed/Rhythmslow tempo, mid-tempo, fast-paced, groovy, driving, laid-backStructure Hintsbuilding intro, catchy chorus, dramatic bridge, fade-out ending"
      },
      {
        "title": "Caption Writing Principles",
        "body": "Specific beats vague — \"sad piano ballad with female breathy vocal\" > \"a sad song\"\nCombine multiple dimensions — style+emotion+instruments+timbre anchors direction precisely\nUse references well — \"in the style of 80s synthwave\" conveys complex aesthetic quickly\nTexture words are useful — warm, crisp, airy, punchy influence mixing and timbre\nDon't pursue perfection — Caption is a starting point, iterate based on results\nGranularity determines freedom — Less detail = more model creativity; more detail = more control\nAvoid conflicting words — \"classical strings\" + \"hardcore metal\" degrades output\n\nFix: Repetition reinforcement — Repeat the elements you want more\nFix: Conflict to evolution — \"Start with soft strings, middle becomes metal rock, end turns to hip-hop\"\n\n\nDon't put BPM/key/tempo in Caption — Use dedicated parameters instead"
      },
      {
        "title": "Lyrics: The Temporal Script",
        "body": "Lyrics controls how music unfolds over time. It carries:\n\nLyric text itself\nStructure tags ([Verse], [Chorus], [Bridge]...)\nVocal style hints ([raspy vocal], [whispered]...)\nInstrumental sections ([guitar solo], [drum break]...)\nEnergy changes ([building energy], [explosive drop]...)"
      },
      {
        "title": "Structure Tags",
        "body": "CategoryTagDescriptionBasic Structure[Intro]Opening, establish atmosphere[Verse] / [Verse 1]Verse, narrative progression[Pre-Chorus]Pre-chorus, build energy[Chorus]Chorus, emotional climax[Bridge]Bridge, transition or elevation[Outro]Ending, conclusionDynamic Sections[Build]Energy gradually rising[Drop]Electronic music energy release[Breakdown]Reduced instrumentation, spaceInstrumental[Instrumental]Pure instrumental, no vocals[Guitar Solo]Guitar solo[Piano Interlude]Piano interludeSpecial[Fade Out]Fade out ending[Silence]Silence"
      },
      {
        "title": "Combining Tags",
        "body": "Use - for finer control, but keep it concise:\n\n✅ [Chorus - anthemic]\n❌ [Chorus - anthemic - stacked harmonies - high energy - powerful - epic]\n\nPut complex style descriptions in Caption, not in tags."
      },
      {
        "title": "Caption-Lyrics Consistency",
        "body": "Models are not good at resolving conflicts. Checklist:\n\nInstruments in Caption ↔ Instrumental section tags in Lyrics\nEmotion in Caption ↔ Energy tags in Lyrics\nVocal description in Caption ↔ Vocal control tags in Lyrics"
      },
      {
        "title": "Vocal Control Tags",
        "body": "TagEffect[raspy vocal]Raspy, textured vocals[whispered]Whispered[falsetto]Falsetto[powerful belting]Powerful, high-pitched singing[spoken word]Rap/recitation[harmonies]Layered harmonies[call and response]Call and response[ad-lib]Improvised embellishments"
      },
      {
        "title": "Energy and Emotion Tags",
        "body": "TagEffect[high energy]High energy, passionate[low energy]Low energy, restrained[building energy]Increasing energy[explosive]Explosive energy[melancholic]Melancholic[euphoric]Euphoric[dreamy]Dreamy[aggressive]Aggressive"
      },
      {
        "title": "Lyric Writing Tips",
        "body": "6-10 syllables per line — Model aligns syllables to beats; keep similar counts for lines in same position (±1-2)\nUppercase = stronger intensity — WE ARE THE CHAMPIONS! (shouting) vs walking through the streets (normal)\nParentheses = background vocals — We rise together (together)\nExtend vowels — Feeeling so aliiive (use cautiously, effects unstable)\nClear section separation — Blank lines between sections"
      },
      {
        "title": "Avoiding \"AI-flavored\" Lyrics",
        "body": "Red FlagDescriptionAdjective stacking\"neon skies, electric hearts, endless dreams\" — vague imagery fillerRhyme chaosInconsistent patterns or forced rhymes breaking meaningBlurred boundariesLyric content crosses structure tagsNo breathing roomLines too long to sing in one breathMixed metaphorsWater → fire → flying — listeners can't anchor\n\nMetaphor discipline: One core metaphor per song, explore its multiple aspects."
      },
      {
        "title": "Music Metadata",
        "body": "Most of the time, let LM auto-infer. Only set manually when you have clear requirements.\n\nParameterRangeDescriptionbpm30–300Slow 60–80, mid 90–120, fast 130–180keyscaleKeye.g. C Major, Am. Common keys (C, G, D, Am, Em) most stabletimesignatureTime sig4/4 (most common), 3/4 (waltz), 6/8 (swing)vocal_languageLanguageUsually auto-detected from lyricsdurationSecondsSee duration calculation below"
      },
      {
        "title": "When to Set Manually",
        "body": "ScenarioSetDaily generationLet LM auto-inferClear tempo requirementbpmSpecific style (waltz)timesignature=3/4Match other materialbpm + durationSpecific key colorkeyscale"
      },
      {
        "title": "Estimation Method",
        "body": "Intro/Outro: 5-10 seconds each\nInstrumental sections: 5-15 seconds each\nTypical structures:\n\n2 verses + 2 choruses: 120-150s minimum\n2 verses + 2 choruses + bridge: 180-240s minimum\nFull song with intro/outro: 210-270s (3.5-4.5 min)"
      },
      {
        "title": "BPM and Duration Relationship",
        "body": "Slower BPM (60-80): Need MORE duration for same lyrics\nMedium BPM (100-130): Standard duration\nFaster BPM (150-180): Can fit more lyrics, but still need breathing room\n\nRule of thumb: When in doubt, estimate longer. A song too short feels rushed.\n\nNote: Lyrics tags (piano, powerful, whispered) are consistent with Caption (piano ballad, building to powerful chorus, intimate)."
      }
    ],
    "body": "ACE-Step Songwriting Guide\n\nProfessional music creation knowledge for writing captions, lyrics, and choosing music parameters for ACE-Step.\n\nOutput Format\n\nAfter using this guide, produce two things for the acestep skill:\n\nCaption (-c): Style/genre/instruments/emotion description\nLyrics (-l): Complete structured lyrics with tags\nParameters: --duration, --bpm, --key, --time-signature, --language\nCaption: The Most Important Input\n\nCaption is the most important factor affecting generated music.\n\nSupports multiple formats: simple style words, comma-separated tags, complex natural language descriptions.\n\nCommon Dimensions\nDimension\tExamples\nStyle/Genre\tpop, rock, jazz, electronic, hip-hop, R&B, folk, classical, lo-fi, synthwave\nEmotion/Atmosphere\tmelancholic, uplifting, energetic, dreamy, dark, nostalgic, euphoric, intimate\nInstruments\tacoustic guitar, piano, synth pads, 808 drums, strings, brass, electric bass\nTimbre Texture\twarm, bright, crisp, muddy, airy, punchy, lush, raw, polished\nEra Reference\t80s synth-pop, 90s grunge, 2010s EDM, vintage soul, modern trap\nProduction Style\tlo-fi, high-fidelity, live recording, studio-polished, bedroom pop\nVocal Characteristics\tfemale vocal, male vocal, breathy, powerful, falsetto, raspy, choir\nSpeed/Rhythm\tslow tempo, mid-tempo, fast-paced, groovy, driving, laid-back\nStructure Hints\tbuilding intro, catchy chorus, dramatic bridge, fade-out ending\nCaption Writing Principles\nSpecific beats vague — \"sad piano ballad with female breathy vocal\" > \"a sad song\"\nCombine multiple dimensions — style+emotion+instruments+timbre anchors direction precisely\nUse references well — \"in the style of 80s synthwave\" conveys complex aesthetic quickly\nTexture words are useful — warm, crisp, airy, punchy influence mixing and timbre\nDon't pursue perfection — Caption is a starting point, iterate based on results\nGranularity determines freedom — Less detail = more model creativity; more detail = more control\nAvoid conflicting words — \"classical strings\" + \"hardcore metal\" degrades output\nFix: Repetition reinforcement — Repeat the elements you want more\nFix: Conflict to evolution — \"Start with soft strings, middle becomes metal rock, end turns to hip-hop\"\nDon't put BPM/key/tempo in Caption — Use dedicated parameters instead\nLyrics: The Temporal Script\n\nLyrics controls how music unfolds over time. It carries:\n\nLyric text itself\nStructure tags ([Verse], [Chorus], [Bridge]...)\nVocal style hints ([raspy vocal], [whispered]...)\nInstrumental sections ([guitar solo], [drum break]...)\nEnergy changes ([building energy], [explosive drop]...)\nStructure Tags\nCategory\tTag\tDescription\nBasic Structure\t[Intro]\tOpening, establish atmosphere\n\t[Verse] / [Verse 1]\tVerse, narrative progression\n\t[Pre-Chorus]\tPre-chorus, build energy\n\t[Chorus]\tChorus, emotional climax\n\t[Bridge]\tBridge, transition or elevation\n\t[Outro]\tEnding, conclusion\nDynamic Sections\t[Build]\tEnergy gradually rising\n\t[Drop]\tElectronic music energy release\n\t[Breakdown]\tReduced instrumentation, space\nInstrumental\t[Instrumental]\tPure instrumental, no vocals\n\t[Guitar Solo]\tGuitar solo\n\t[Piano Interlude]\tPiano interlude\nSpecial\t[Fade Out]\tFade out ending\n\t[Silence]\tSilence\nCombining Tags\n\nUse - for finer control, but keep it concise:\n\n✅ [Chorus - anthemic]\n❌ [Chorus - anthemic - stacked harmonies - high energy - powerful - epic]\n\n\nPut complex style descriptions in Caption, not in tags.\n\nCaption-Lyrics Consistency\n\nModels are not good at resolving conflicts. Checklist:\n\nInstruments in Caption ↔ Instrumental section tags in Lyrics\nEmotion in Caption ↔ Energy tags in Lyrics\nVocal description in Caption ↔ Vocal control tags in Lyrics\nVocal Control Tags\nTag\tEffect\n[raspy vocal]\tRaspy, textured vocals\n[whispered]\tWhispered\n[falsetto]\tFalsetto\n[powerful belting]\tPowerful, high-pitched singing\n[spoken word]\tRap/recitation\n[harmonies]\tLayered harmonies\n[call and response]\tCall and response\n[ad-lib]\tImprovised embellishments\nEnergy and Emotion Tags\nTag\tEffect\n[high energy]\tHigh energy, passionate\n[low energy]\tLow energy, restrained\n[building energy]\tIncreasing energy\n[explosive]\tExplosive energy\n[melancholic]\tMelancholic\n[euphoric]\tEuphoric\n[dreamy]\tDreamy\n[aggressive]\tAggressive\nLyric Writing Tips\n6-10 syllables per line — Model aligns syllables to beats; keep similar counts for lines in same position (±1-2)\nUppercase = stronger intensity — WE ARE THE CHAMPIONS! (shouting) vs walking through the streets (normal)\nParentheses = background vocals — We rise together (together)\nExtend vowels — Feeeling so aliiive (use cautiously, effects unstable)\nClear section separation — Blank lines between sections\nAvoiding \"AI-flavored\" Lyrics\nRed Flag\tDescription\nAdjective stacking\t\"neon skies, electric hearts, endless dreams\" — vague imagery filler\nRhyme chaos\tInconsistent patterns or forced rhymes breaking meaning\nBlurred boundaries\tLyric content crosses structure tags\nNo breathing room\tLines too long to sing in one breath\nMixed metaphors\tWater → fire → flying — listeners can't anchor\n\nMetaphor discipline: One core metaphor per song, explore its multiple aspects.\n\nMusic Metadata\n\nMost of the time, let LM auto-infer. Only set manually when you have clear requirements.\n\nParameter\tRange\tDescription\nbpm\t30–300\tSlow 60–80, mid 90–120, fast 130–180\nkeyscale\tKey\te.g. C Major, Am. Common keys (C, G, D, Am, Em) most stable\ntimesignature\tTime sig\t4/4 (most common), 3/4 (waltz), 6/8 (swing)\nvocal_language\tLanguage\tUsually auto-detected from lyrics\nduration\tSeconds\tSee duration calculation below\nWhen to Set Manually\nScenario\tSet\nDaily generation\tLet LM auto-infer\nClear tempo requirement\tbpm\nSpecific style (waltz)\ttimesignature=3/4\nMatch other material\tbpm + duration\nSpecific key color\tkeyscale\nDuration Calculation\nEstimation Method\nIntro/Outro: 5-10 seconds each\nInstrumental sections: 5-15 seconds each\nTypical structures:\n2 verses + 2 choruses: 120-150s minimum\n2 verses + 2 choruses + bridge: 180-240s minimum\nFull song with intro/outro: 210-270s (3.5-4.5 min)\nBPM and Duration Relationship\nSlower BPM (60-80): Need MORE duration for same lyrics\nMedium BPM (100-130): Standard duration\nFaster BPM (150-180): Can fit more lyrics, but still need breathing room\n\nRule of thumb: When in doubt, estimate longer. A song too short feels rushed.\n\nNote: Lyrics tags (piano, powerful, whispered) are consistent with Caption (piano ballad, building to powerful chorus, intimate)."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/DumoeDss/acestep-songwriting",
    "publisherUrl": "https://clawhub.ai/DumoeDss/acestep-songwriting",
    "owner": "DumoeDss",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/acestep-songwriting",
    "downloadUrl": "https://openagent3.xyz/downloads/acestep-songwriting",
    "agentUrl": "https://openagent3.xyz/skills/acestep-songwriting/agent",
    "manifestUrl": "https://openagent3.xyz/skills/acestep-songwriting/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/acestep-songwriting/agent.md"
  }
}