suno-prompt-scorer

Score Suno AI music prompts on a 100-point scale — before you burn a credit.

A zero-dependency TypeScript library that scores Suno prompts across four dimensions. The scoring algorithm is the same one powering AceTagGen's free public scorer.

Why

Most Suno prompt-scoring tools are paywalled, scraped from stale wikis, or don't respect Suno's constraints. This package is:

• Free and open (MIT)
• Zero dependencies — runs anywhere: browser, Node, edge, Deno
• Suno-specific — built around the 200-char Style field limit
• Tested on Suno v4/v4.5 — collision rules come from real generation testing

Install

npm install suno-prompt-scorer

Usage

import { scorePrompt } from "suno-prompt-scorer";

const result = scorePrompt("dark trap, melodic 808 bass, triplet hi-hat rolls, reverb-heavy");

console.log(result.total);      // 94
console.log(result.breakdown);  // Per-metric explanation

Return shape

{
  prompt: string;
  total: number;               // 0–100
  breakdown: Array<{
    label: "length" | "collisions" | "specificity" | "density";
    pct: number;               // 0–100
    status: "good" | "warn" | "bad";
    message: string;           // human-readable explanation
  }>;
  meta: {
    chars: number;
    words: number;
    version: 1;
    tool: "suno-prompt-scorer";
  };
}

What it scores

| Metric | What it checks | |---|---| | Length | Whether your prompt fits Suno's 200-character Style field (Suno silently truncates past this). | | Collisions | Contradictory tag pairs that confuse generation (e.g. lo-fi + crisp, dreamy + aggressive). | | Specificity | Whether you have actual production tags (instruments, FX) or just mood words. | | Density | Tag count — sweet spot is 4–25. Too few is vague, too many dilutes. |

Also available

• Live tool: https://acetaggen.com/tools/prompt-scorer (same scorer, zero install)
• Public API: GET https://acetaggen.com/api/suno-score?prompt=... (CORS-enabled)
• Full builder: https://acetaggen.com — a 12-step questionnaire that assembles Suno-ready prompts from 3,000+ tested tags

License

MIT © Shai Zadok

Built and maintained by AceTagGen — the tag generator built for Suno AI musicians.