agentsclimarketplace

Discogs database

Skill Nikolasgrizli/discogs-api-skills/discogs-database

Model-agnostic Agent Skills covering the entire public Discogs API (api.discogs.com).

Install
npx -y skills add Nikolasgrizli/discogs-api-skills --skill discogs-database

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Reference for the Discogs database endpoints (api.discogs.com) — the read-only catalog of music metadata. Make sure to use this skill whenever the task involves fetching or searching Discogs Releases, Masters, Artists, or Labels, even if "database" isn't said: getting a release/master/artist/label by id, listing an artist's or label's releases, master versions, release stats and community/user ratings (including PUT/DELETE a user's rating), pulling release videos, or running /database/search by query, barcode, catalog number, type, genre, year, etc. Also use it when deciding which query-string filters or sort options a database call supports.

SKILL.md

2.2 KB, 410 tokens by cl100k_base, as published. Nobody here has run it

Discogs API — Database

Read-only music catalog. Note: image URLs and the high rate-limit tier require auth (Consumer Key/Secret or better — see [[discogs-authentication]]). Search requires authentication.

Endpoints

MethodPathPurpose
GET/releases/{release_id}{?curr_abbr}A single release (specific pressing)
GET/releases/{release_id}/rating/{username}A user's rating of a release
PUT/releases/{release_id}/rating/{username}Set the user's rating (auth)
DELETE/releases/{release_id}/rating/{username}Remove the user's rating (auth)
GET/releases/{release_id}/ratingCommunity (average) rating
GET/releases/{release_id}/statsRelease stats (have/want counts)
GET/masters/{master_id}A master release (groups all versions)
GET/masters/{master_id}/versions{?page,per_page}All versions of a master
GET/artists/{artist_id}An artist
GET/artists/{artist_id}/releases{?sort,sort_order}An artist's releases
GET/labels/{label_id}A label
GET/labels/{label_id}/releases{?page,per_page}A label's releases
GET/database/search?q={query}Search (auth required)

/database/search filters: type, title, release_title, credit, artist, anv, label, genre, style, country, year, format, catno, barcode, track, submitter, contributor. curr_abbr controls the currency for marketplace pricing fields.

See reference.md for full parameter and response-field details.

Gives 0 of the 12 instructions most databases sql skills give in 410 tokens

Counted across 589 of the 662 authors here whose files we hold, read 2026-08-06

  • use parameterized queriesin 36 of 589, across 32 files
  • use timestamptz for timestampsin 30 of 589, across 12 files
  • create indexes concurrentlyin 29 of 589, across 23 files
  • index foreign keysin 28 of 589, across 17 files
  • use numeric type for moneyin 25 of 589, across 8 files
  • select only required columnsin 24 of 589, across 19 files
  • use cursor pagination instead of OFFSETin 23 of 589, across 15 files
  • add indexes manually on foreign key columnsin 22 of 589, across 11 files
  • read individual rule files for detailed explanationsin 18 of 589, across 4 files
  • configure connection poolingin 18 of 589, across 16 files
  • put equality columns before range columns in indexesin 17 of 589, across 9 files
  • normalize to third normal formin 17 of 589, across 8 files

Said here and by no other author read

  • use database endpoints for releases masters artists labels search
  • require authentication for search
  • require authentication for high rate limits
  • require authentication for image urls
  • set a user rating with put
  • remove a user rating with delete

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.