JasonColapietro/suede-creator-skills / skills/suede-release-linter
suede-release-linter
FlaggedFind missing files, malformed metadata, artwork and stem issues, split gaps, AI involvement, and delivery blockers in local music or media release folders. Use when asked to "check this release folder" or explain a delivery rejection. Writes scored Markdown and JSON reports; unknown facts remain unknown. NOT FOR: resolving rights or building a transfer package (use suede-rights-passport), sync one-sheets (use suede-sync-packaging), or rollout campaigns (use suede-campaign-in-a-box).
references/lint-rules.md
View on GitHub# Release Lint Rules
## Severity Levels
- `error`: Recommends blocking release, downstream review, registry, licensing, royalty routing, or agent commerce. The status is a report to the creator, not an action lock; the creator decides what proceeds.
- `warning`: Does not usually warrant a blocked recommendation, but should be fixed before public release or monetization.
- `info`: Useful improvement or optional cleanup.
## Score
Start at 100.
- Each `error` subtracts 15 points.
- Each `warning` subtracts 5 points.
- Each `info` subtracts 1 point.
- Minimum score is 0.
Score bands:
- `90-100`: strong
- `75-89`: usable with cleanup
- `50-74`: needs work
- `0-49`: blocked
## Required Categories
### Core Release Metadata
Error when title or artist/creator name is missing.
Warning when release date, genre, language, description, tags, explicit-content status, or public URLs are missing.
### Primary Media
Error when no primary audio/video file exists.
Warning when only low-quality or compressed audio is present and no WAV/AIFF/FLAC master exists.
Info when multiple possible masters are present and the final master is not obvious.
### Artwork
Warning when no artwork image is present.
Warning when artwork exists but is not square or is smaller than common distribution expectations. The script only checks dimensions when Pillow is installed.
### Lyrics And Timed Text
Info when no lyrics are present.
Warning when the release is clearly vocal music and no lyrics are present. Agents should infer this only from filenames or provided metadata, not guess from audio content.
### Stems
Info when no stems are present.
Warning when the user intends remix, sync, licensing, agent commerce, or optimization and no stems are present.
### Credits And Splits
Error when contributors, credits, or split details are missing.
Error when split totals are present but do not add to 100 for master or publishing.
Warning when contributors exist but confirmation status is missing.
### Rights And Licenses
Error when sample, cover, interpolation, loop, or third-party beat status is unknown.
Error when a project claims samples exist but clearance status is missing or uncleared.
Warning when release/distribution history is unknown.
Info when AI involvement is not stated (`ai_involvement` missing or unknown).
Use `none` when no generative AI was used.
Warning when AI involvement is declared but `human_authorship` notes are
missing. Spotify and other DSPs now carry AI credits supplied through
distributors, and the US Copyright Office treats purely AI-generated material
as uncopyrightable, so undocumented human authorship weakens registration and
licensing.
### Downstream Readiness
Error when ownership, contributors, splits, or sample status blocks registry/licensing/royalty routing.
Warning when provenance notes, file hashes, wallet/payment destinations, or intended services are missing.
Info when the project is a good candidate for `suede-rights-passport`.
## Sources
- Spotify, AI protections and DDEX-based AI credits (2025-09-25):
<https://newsroom.spotify.com/2025-09-25/spotify-strengthens-ai-protections/>
- U.S. Copyright Office, *Copyright and Artificial Intelligence, Part 2:
Copyrightability* (January 2025):
<https://www.copyright.gov/ai/Copyright-and-Artificial-Intelligence-Part-2-Copyrightability-Report.pdf>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |