/suede-release-linter · Release readiness lint

Catch the broken metadata before the drop does.

It emits two reports, one a person reads and one a machine reads, and the public script runs offline, so the catalog never leaves the drive. Point it at a song, an album, a stem pack, an artwork or lyric folder, or a whole media project and it scores release readiness: missing files, malformed metadata, artwork and stem problems, split gaps, rights blockers, and platform-delivery issues. Findings only; it clears nothing.

View skill folder Create a rights package

"lint this release folder before the drop" /suede-release-linter Ask in plain words. The router reads the request and loads this lane; MCP agents find it with list_suede_skills.
$ /suede-release-linter check ./release artwork 3000x3000 pass · audio levels pass gap · missing ISRC on track 3 1 BLOCKER · FIX BEFORE THE DROP
Suede Release Linter preview card for release readiness and missing metadata.

What it checks

  • Title, artist, release type, project identity, and metadata files.
  • Final masters, source sessions, stems, artwork, lyrics, and documents.
  • Contributor credits, split totals, sample status, licenses, and release history.
  • Provenance notes, public URLs, platform-delivery blockers, and downstream handoff readiness.
  • Secret-like files and unsafe output choices that should not be shared publicly.

Best for

  • Creators checking a release folder before upload or distribution.
  • Labels and managers cleaning metadata before licensing review.
  • Catalog owners finding missing credits, stems, artwork, lyrics, and rights details.
  • Developers preparing structured media projects for review or agent workflows.
  • Teams deciding whether to move from linting into rights package generation.

Run it locally

The script writes a markdown report and a JSON report. Pass public-safe metadata when available.

python3 skills/suede-release-linter/scripts/lint_release.py \
  /path/to/music-project \
  --metadata /path/to/music-project/metadata.json \
  --output /path/to/release-lint-output

Safety defaults skip hidden files, dependency folders, build outputs, caches, secret-like files, and unrecognized file types. Absolute paths are redacted unless explicitly requested. Existing report files require --force before replacement.

All skill links

Skill manifestAgent-facing workflow, trigger description, lint flow, safety rules, and completion checklist. OpenAI metadataDisplay name, short description, and default prompt for skill-list surfaces. Lint scriptScans a release folder, classifies files, applies metadata rules, and writes markdown plus JSON reports. ReferencesLint rules, metadata fields, fix guidance, and downstream review context. TemplatesExample metadata plus markdown and JSON report templates for repair or manual report work. Rights package next stepUse the lint report to decide whether the project is ready to become a local transfer package.

Install prompts

After copying the skill folder into an agent skill root, use prompts like:

Use $suede-release-linter to audit this album folder for release readiness.
Use the suede-release-linter skill to check this release folder.

Public safety

A clean report is not legal clearance, distributor approval, registry write, or payout guarantee. The skill organizes evidence, marks uncertainty, and recommends next fixes. Generated reports are drafts until a creator or operator reviews and redacts them.

Install this skill

It ships inside the Suede Creator Skills pack, so one install brings the whole pack and this skill with it. Claude Code takes two commands the first time and one after that; Codex installs the same pack natively.

terminal · install the pack
Claude Code 
$ /plugin marketplace add JasonColapietro/suede-creator-skills
$ /plugin install suede-skills@suede
Codex 
$ codex plugin add suede-skills@suede-codex

Cursor, Copilot, and Windsurf install through the skills CLI. Every path is on the install page, and every folder is readable first on GitHub.

Proof is part of the release.

First install takes two commands. After the marketplace is added, install is one. Every skill is plain Markdown.

$ /plugin marketplace add JasonColapietro/suede-creator-skills → /plugin install suede-skills@suede All install paths