How do I install the Discogs CLI skill?

Run npx skillmds@latest add dvcrn/discogs-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Discogs CLI skill do?

An OpenClaw skill to manage a user's vinyl record collection on Discogs. It is listed under Coding & Dev Tools on SkillMD.

Is Discogs CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Discogs CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Discogs CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Discogs CLI?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Discogs CLI by dvcrn — Agent Skill

Name: Discogs CLI
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

File contents

Discogs Collection Manager Skill for OpenClaw

This skill provides a command-line interface to interact with a user's record collection on Discogs.com. It is designed specifically for use within the OpenClaw assistant and uses a subcommand structure similar to git or gog.

Prerequisites

This skill is a Go program and requires the Go toolchain to be installed.

Installation (Debian/Ubuntu): sudo apt-get update && sudo apt-get install -y golang-go

One-Time Setup

Before first use, you must run the included installer script. This will compile the Go binary and place it in a predictable location within the skill's directory.

Run the installer:
```
skills/discogs-cli/install.sh
```
Configure Credentials: This command saves your Discogs token and username to a configuration file (~/.config/discogs-cli/config.yaml).
```
skills/discogs-cli/bin/discogs-cli config set -u "YourUsername" -t "YourSecretToken"
```

Usage

All commands must be prefixed with the full path to the binary.

Fetch Album Art

Downloads the album art for a given release and displays it in the chat.

skills/discogs-cli/bin/discogs-cli release art <release_id>

List Collection Folders

Shows all folders and their record counts.

skills/discogs-cli/bin/discogs-cli collection list-folders

List Releases in a Folder

Shows all records within a specific folder. The output is a formatted table.

# List all releases from the "All" folder (default)
skills/discogs-cli/bin/discogs-cli collection list

# List all releases from a specific folder by ID
skills/discogs-cli/bin/discogs-cli collection list --folder 8815833

Search the Discogs Database

Search for releases, artists, or labels.

# Search for a release (default type)
skills/discogs-cli/bin/discogs-cli search "Daft Punk - Discovery"

# Search for an artist
skills/discogs-cli/bin/discogs-cli search --type artist "Aphex Twin"

Manage Your Wantlist

Work with your Discogs wantlist.

List Your Wantlist

Displays all items in your wantlist.

skills/discogs-cli/bin/discogs-cli wantlist list

Add to Your Wantlist

Adds a release to your wantlist by its ID.

skills/discogs-cli/bin/discogs-cli wantlist add 12345

Remove from Your Wantlist

Removes a release from your wantlist by its ID.

skills/discogs-cli/bin/discogs-cli wantlist remove 12345

Caching and Valuation Commands

These commands rely on a local cache for performance. You must run sync first to populate the cache.

Sync Collection Details (Slow)

Fetches detailed data for every item in the collection and builds a local cache. This command is slow and should be run in the background. Inform the user that this will take time.

skills/discogs-cli/bin/discogs-cli collection sync

Get Collection Value (Fast)

Reads the local cache to provide the estimated market value for each item and the total collection. This command is fast. If it fails, the cache is likely missing, and you need to run the sync command.

skills/discogs-cli/bin/discogs-cli collection value

Get Single Release Details (Fast)

Provides a detailed view of a single release, including tracklist.

skills/discogs-cli/bin/discogs-cli collection get 35198584

---name: discogs-clidescription: An OpenClaw skill to manage a user's vinyl record collection on Discogs.---# Discogs Collection Manager Skill for OpenClawThis skill provides a command-line interface to interact with a user's record collection on Discogs.com. It is designed specifically for use within the OpenClaw assistant and uses a subcommand structure similar to `git` or `gog`.## PrerequisitesThis skill is a Go program and requires the Go toolchain to be installed.**Installation (Debian/Ubuntu):**`sudo apt-get update && sudo apt-get install -y golang-go`## One-Time SetupBefore first use, you must run the included installer script. This will compile the Go binary and place it in a predictable location within the skill's directory.1. **Run the installer:** ```bash skills/discogs-cli/install.sh ```2. **Configure Credentials:** This command saves your Discogs token and username to a configuration file (`~/.config/discogs-cli/config.yaml`). ```bash skills/discogs-cli/bin/discogs-cli config set -u "YourUsername" -t "YourSecretToken" ```## UsageAll commands must be prefixed with the full path to the binary.### Fetch Album ArtDownloads the album art for a given release and displays it in the chat.```bashskills/discogs-cli/bin/discogs-cli release art <release_id>```### List Collection FoldersShows all folders and their record counts.```bashskills/discogs-cli/bin/discogs-cli collection list-folders```### List Releases in a FolderShows all records within a specific folder. The output is a formatted table.```bash# List all releases from the "All" folder (default)skills/discogs-cli/bin/discogs-cli collection list# List all releases from a specific folder by IDskills/discogs-cli/bin/discogs-cli collection list --folder 8815833```## Search the Discogs DatabaseSearch for releases, artists, or labels.```bash# Search for a release (default type)skills/discogs-cli/bin/discogs-cli search "Daft Punk - Discovery"# Search for an artistskills/discogs-cli/bin/discogs-cli search --type artist "Aphex Twin"```## Manage Your WantlistWork with your Discogs wantlist.### List Your WantlistDisplays all items in your wantlist.```bashskills/discogs-cli/bin/discogs-cli wantlist list```### Add to Your WantlistAdds a release to your wantlist by its ID.```bashskills/discogs-cli/bin/discogs-cli wantlist add 12345```### Remove from Your WantlistRemoves a release from your wantlist by its ID.```bashskills/discogs-cli/bin/discogs-cli wantlist remove 12345```## Caching and Valuation CommandsThese commands rely on a local cache for performance. You must run `sync` first to populate the cache.### Sync Collection Details (Slow)Fetches detailed data for every item in the collection and builds a local cache. This command is slow and should be run in the background. Inform the user that this will take time.```bashskills/discogs-cli/bin/discogs-cli collection sync```### Get Collection Value (Fast)Reads the local cache to provide the estimated market value for each item and the total collection. This command is fast. If it fails, the cache is likely missing, and you need to run the `sync` command.```bashskills/discogs-cli/bin/discogs-cli collection value```### Get Single Release Details (Fast)Provides a detailed view of a single release, including tracklist.```bashskills/discogs-cli/bin/discogs-cli collection get 35198584```

Frequently asked questions

Discogs CLI