suno-profile

Manages Suno profile bio, genre tags, pinned songs, and playlists via the reverse-engineered Suno write API.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/franklinbaldo/skills --skill suno-profile-franklinbaldo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: suno-profile
Source: https://github.com/franklinbaldo/skills/tree/main/suno-profile
Command: npx skills add https://github.com/franklinbaldo/skills --skill suno-profile-franklinbaldo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) and references (resource) components.

What problem does it solve? Editing a Suno profile (bio, genre tags, pinned-song captions, playlists) through reverse-engineered API endpoints is error-prone: full-object PATCH calls can overwrite live data, session tokens expire hourly, and piecemeal edits produce an incoherent profile. This Skill documents every write endpoint, enforces per-action authorization, and provides curation planning so the profile stays coherent as a whole. ## Core Features & Use Cases - Documented write API: Reference material covers every reverse-engineered Suno write endpoint (song metadata, tags, cover, visibility, profile, playlists) with request shapes, known backend bugs, and propagation-delay behavior. - Session management scripts: Node scripts capture a durable Clerk session cookie into Windows Credential Manager and mint fresh Bearer tokens on demand, avoiding hourly token re-pasting. - Catalog export and AI critique: Scripts export the full catalog (songs, lyrics, captions, playlists, profile) to markdown for Gemini Q&A, and send actual song audio to Gemini via Portkey for listening-based critiques that ground caption writing. - Curation planning and quality review: References define a profile-wide curation plan template, a mandatory self-critique cadence, and a periodic quality-review process for finding low-quality songs to trash (only with explicit authorization). - Use Case: Draft a new profile bio and five genre tags grounded in an audio critique of the pinned songs, present them as drafts, then apply only the specific changes explicitly authorized, verifying each read-back. ## Quick Start Ask the agent to read the live Suno profile state and draft improved bio and genre tag wording using the seo-and-taste guidance, presenting drafts for approval before any write is applied.

Frequently Asked Questions about suno-profile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a Suno profile bio via the API?▼

Use the profile PATCH endpoint documented in references/write-api.md, but send the full object with every field, not just the changed one. Fetch current state first, since a partial update once overwrote a live bio with placeholder text.

How do I get a Suno API session token for write access?▼

Either paste a fresh Bearer JWT captured from browser DevTools (valid about one hour), or run scripts/login-and-capture.mjs once to store the durable Clerk cookie in Windows Credential Manager, then mint fresh tokens with scripts/mint-bearer-token.mjs.

Can the skill change my Suno profile automatically?▼

No. Every write to Suno requires explicit per-action authorization from the account owner in that session. The skill drafts wording and documents endpoints, but documented capability is never standing permission to apply changes.

How do I send Suno song audio to Gemini for a critique?▼

Run scripts/gemini-audio-critic.mjs with --track flags pointing at audio URLs or local files. Small tracks go inline as base64 through Portkey; large tracks upload via Google's Files API, which additionally requires GEMINI_API_KEY.

Why did my Suno write succeed but not appear on the profile?▼

Suno write endpoints can return success before the change is visible on the next read due to propagation delay. Check the propagation-delay notes in references/write-api.md before concluding a write failed or retrying it.

What audio formats does the Gemini critique script support?▼

Only Gemini's officially documented formats: WAV, MP3, AIFF, AAC, OGG Vorbis, and FLAC. M4A, Opus, and WebM are rejected rather than mislabeled, and audio/mpeg Content-Types are normalized to audio/mp3.