Agent skill

Discogs Sync

by LeoYeAI in LeoYeAI/openclaw-master-skills

Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID.

Install Discogs Sync

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/discogs-sync .claude/skills/discogs-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .claude/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/discogs-sync .agents/skills/discogs-sync && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .agents/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/discogs-sync .cursor/skills/discogs-sync && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .cursor/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/discogs-sync

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/discogs-sync .gemini/skills/discogs-sync && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .gemini/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/discogs-sync .github/skills/discogs-sync && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .github/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills discogs-sync --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/discogs-sync .opencode/skills/discogs-sync && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "discogs-sync" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/discogs-sync into .opencode/skills/discogs-sync/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discogs-sync", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: discogs-sync
GitHub stars: 2.2k
Token cost: ~3.9k tokens
SKILL.md length: 912 words
Files: 20
Skills in repo: 972
Repo updated: Jul 20, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID.

Works in 3 steps: Structured search — artist, album,… → Relaxed search — drops format and year… → Free text search — searches "artist…
The user asks to add
SKILL.md covers Runtime & Dependencies, Quick Start, Authentication and Usage, plus 6 more sections
Runs Python scripts from its folder; calls python3 and pip

What it does

Discogs Sync is an agent skill from LeoYeAI/openclaw-master-skills. Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID. Search marketplace pricing for vinyl, CD, and other formats. List wantlist and collection contents. Use when the user asks to add or remove a record from their Discogs wantlist or collection, check what's on their wantlist, look up marketplace prices, or find what a record is selling for. Also supports bulk operations via CSV/JSON file input.

Its SKILL.md is about 3.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files (for example `_meta.json`, `discogs-sync.py` and `src/discogs_sync/__init__.py`).

It sits in Documents & Office, covering CSV and tabular files. It works with Python. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

The user asks to add
Remove a record from their Discogs wantlist
Check whats on their wantlist
Look up marketplace prices

Example prompts

“/discogs-sync”

Requirements

Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Structured search — artist, album, format, and year
Relaxed search — drops format and year constraints
Free text search — searches "artist album" as plain text

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- python3
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- discogs.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Discogs Sync loads about 3.9k tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 912 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~117
When it runs · the whole SKILL.md, loaded when a task matches: ~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 912 words, ~3,930 tokens.

Download SKILL.mdSave it as .claude/skills/discogs-sync/SKILL.md (or your agent's skills folder). This skill also uses 19 other files; get the full folder from GitHub.

name: discogs-sync
description: Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID. Search marketplace pricing for vinyl, CD, and other formats. List wantlist and collection contents. Use when the user asks to add or remove a record from their Discogs wantlist or collection, check what's on their wantlist, look up marketplace prices, or find what a record is selling for. Also supports bulk operations via CSV/JSON file input.

Discogs Sync — Wantlist, Collection & Marketplace CLI

Add and remove albums from your Discogs wantlist or collection, search marketplace pricing, and list what you have. Identify albums by artist/album name, Discogs master ID, or release ID. For bulk operations, pass a CSV or JSON file.

Runtime & Dependencies

Runtime: Python 3.10+

Python packages (installed automatically on first run):

python3-discogs-client>=2.8 — Discogs API client
click>=8.1 — CLI framework
rich>=13.0 — Terminal output formatting

Installation: No manual pip install needed. On first run, discogs-sync.py creates a local .deps/ virtual environment inside the skill directory and installs dependencies from requirements.txt. Subsequent runs reuse the existing venv. This works on macOS (including Homebrew Python), Linux, and Windows without requiring system-level package installation.

To force a clean reinstall of dependencies, delete the .deps/ directory and run any command again.

Quick Start

bash

# Authenticate (one-time setup — also installs dependencies on first run)
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py auth

# Add an album to your wantlist by name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist add --artist "Radiohead" --album "OK Computer"

# Add to your collection by release ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection add --release-id 7890

# Check marketplace prices for a vinyl pressing
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --artist "Miles Davis" --album "Kind of Blue" --format Vinyl

# List your wantlist
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist list

# Remove from collection
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection remove --artist "Nirvana" --album "Nevermind"

Authentication

Run once to authenticate. Two modes are available:

Personal access token (default) — simplest option. Generate a token at https://www.discogs.com/settings/developers.

bash

python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py auth
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py auth --mode token

OAuth 1.0a — full OAuth flow with consumer key/secret, for apps that need delegated access.

bash

python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py auth --mode oauth

Credentials are stored in ~/.discogs-sync/config.json.

bash

# Verify authentication
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py whoami
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py whoami --output-format json

Usage

Wantlist — Add, Remove, List

bash

# Add by artist/album name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist add --artist "Radiohead" --album "OK Computer" [--format Vinyl]

# Add by Discogs master ID (resolves to main release, or filters by --format)
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist add --master-id 3425

# Add by specific release ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist add --release-id 7890

# Remove by artist/album name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist remove --artist "Radiohead" --album "OK Computer"

# Remove by release ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist remove --release-id 7890

# List current wantlist
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist list [--search "QUERY"] [--format Vinyl] [--year 1997] [--no-cache] [--output-format json]

Duplicate check: skips if the release is already in the wantlist (by release_id, master_id, or fuzzy artist+title match).

Collection — Add, Remove, List

bash

# Add by artist/album name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection add --artist "Miles Davis" --album "Kind of Blue" [--format Vinyl]

# Add by master ID or release ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection add --master-id 3425 [--folder-id 1]
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection add --release-id 7890 [--folder-id 1]

# Add a second copy of something already owned
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection add --release-id 7890 --allow-duplicate

# Remove by artist/album name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection remove --artist "Miles Davis" --album "Kind of Blue"

# Remove by release ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection remove --release-id 7890

# List collection (all folders)
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection list [--search "QUERY"] [--format CD] [--year 1959] [--folder-id 0] [--no-cache] [--output-format json]

Duplicate check: by default, add skips if the release is already in the collection (by release_id, master_id, or fuzzy artist+title match). Use --allow-duplicate to add another copy.

Marketplace — Search Pricing

bash

# Search by artist/album name
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --artist "Radiohead" --album "OK Computer" [--format Vinyl] [--country US] [--output-format json]

# Search by master ID
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --master-id 3425 [--format Vinyl] [--country US]

# Search by specific release ID (skips master version scan)
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --release-id 7890

# Filter by price range and country
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --artist "Pink Floyd" --album "The Dark Side of the Moon" --format Vinyl --country US --min-price 10 --max-price 50 --currency USD

# Show detailed progress and condition grade price suggestions
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search --artist "Radiohead" --album "OK Computer" --verbose --details

Returns release versions sorted by lowest price, with number of copies for sale. Single-item results are cached for 1 hour by lookup parameters. With --details, a separate details cache entry is used; if only the base cache is warm the tool fetches just the condition-grade price suggestions rather than re-running the full search. Pass --no-cache to force a live fetch (result is still written to cache).

Bulk Operations via File

For batch operations, pass a CSV or JSON file instead of individual --artist/--album flags.

bash

# Sync wantlist from file (preview first with --dry-run)
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist sync albums.csv --dry-run
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py wantlist sync albums.csv [--remove-extras] [--threshold 0.7] [--output-format json]

# Sync collection from file
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py collection sync albums.csv [--folder-id 1] [--remove-extras] [--dry-run]

# Batch marketplace search from file
python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py marketplace search albums.csv [--format Vinyl] [--country US] [--max-price 50] [--max-versions 25] [--output-format json]

CSV format (header row required, artist and album required):

csv

artist,album,format,year,notes
Radiohead,OK Computer,Vinyl,,Must have
Miles Davis,Kind of Blue,,1959,Original pressing
Nirvana,Nevermind,CD,1991,

JSON format (array of objects with the same fields):

json

[
    {"artist": "Radiohead", "album": "OK Computer", "format": "Vinyl"},
    {"artist": "Miles Davis", "album": "Kind of Blue", "year": 1959}
]

Format synonyms are normalized automatically: LP/record/12" → Vinyl, compact disc → CD, tape/mc → Cassette.

Options

Option	Applies To	Description
`--output-format`	All	`table` (default) or `json` for machine-readable output
`--threshold`	add, remove, search, sync	Match score threshold 0.0–1.0 (default: 0.7)
`--format`	add, list, marketplace search	Filter by format: Vinyl, CD, Cassette (synonyms like LP, record are normalized)
`--year`	list	Filter by release year (exact match)
`--folder-id`	collection	Target folder (default: 1 for adds, 0 for reads)
`--allow-duplicate`	collection add	Allow adding another copy of an album already in collection
`--country`	marketplace search	Filter by country of pressing (exact match: US, UK, Germany, etc.)
`--release-id`	marketplace search	Fetch stats for a specific release (bypasses master version scan)
`--min-price`	marketplace	Minimum price filter
`--max-price`	marketplace	Maximum price filter
`--currency`	marketplace	Currency code (default: USD)
`--max-versions`	marketplace	Max release versions to check per master (default: 25)
`--details`	marketplace search	Include suggested prices by condition grade
`--no-cache`	list, marketplace search	Bypass local cache; fresh results are still written back to cache
`--verbose`	sync, marketplace search	Show detailed progress and API call logging
`--search`	list	Filter results by artist or title (case-insensitive substring match)
`--dry-run`	sync	Preview changes without modifying Discogs
`--remove-extras`	sync	Remove wantlist/collection items not in the input file

Output Format

Text (Default)

wantlist list / collection list:

                           Wantlist
┌────────────┬───────────┬─────────────┬─────────────┬────────┬──────┐
│ Release ID │ Master ID │ Artist      │ Title       │ Format │ Year │
├────────────┼───────────┼─────────────┼─────────────┼────────┼──────┤
│ 7890       │ 3425      │ Radiohead   │ OK Computer │ Vinyl  │ 1997 │
│ 1234       │ 1000      │ Miles Davis │ Kind of Blue│ Vinyl  │ 1959 │
└────────────┴───────────┴─────────────┴─────────────┴────────┴──────┘

Total: 2

marketplace search:

                               Marketplace Results
┌───────────┬────────────┬───────────┬─────────────┬────────┬──────────┬──────────────┐
│ Master ID │ Release ID │ Artist    │ Title       │ Format │ For Sale │ Lowest Price │
├───────────┼────────────┼───────────┼─────────────┼────────┼──────────┼──────────────┤
│ 3425      │ 7890       │ Radiohead │ OK Computer │ Vinyl  │ 42       │ 25.99 USD    │
│ 3425      │ 15432      │ Radiohead │ OK Computer │ Vinyl  │ 18       │ 32.50 USD    │
└───────────┴────────────┴───────────┴─────────────┴────────┴──────────┴──────────────┘

add / remove result:

Sync Report
  Total input: 1
  Added:   1
  Removed: 0
  Skipped: 0
  Errors:  0

Show full SKILL.md (367 more words)Show less

JSON (`--output-format json`)

wantlist list / collection list:

json

{
  "items": [
    {
      "release_id": 7890,
      "master_id": 3425,
      "title": "OK Computer",
      "artist": "Radiohead",
      "format": "Vinyl",
      "year": 1997
    }
  ],
  "total": 1
}

marketplace search:

json

{
  "results": [
    {
      "master_id": 3425,
      "release_id": 7890,
      "title": "OK Computer",
      "artist": "Radiohead",
      "format": "Vinyl",
      "country": "US",
      "year": 1997,
      "num_for_sale": 42,
      "lowest_price": 25.99,
      "currency": "USD"
    }
  ],
  "total": 1
}

add / remove / sync report:

json

{
  "summary": {
    "total_input": 1,
    "added": 1,
    "removed": 0,
    "skipped": 0,
    "errors": 0
  },
  "actions": [
    {
      "action": "add",
      "artist": "Radiohead",
      "title": "OK Computer",
      "release_id": 7890,
      "master_id": 3425,
      "reason": null,
      "error": null
    }
  ]
}

Output Fields

release_id — Unique Discogs release identifier
master_id — Discogs master release identifier (groups all versions of an album)
title — Album title
artist — Artist name
format — Physical format (Vinyl, CD, Cassette, etc.)
year — Release year
country — Country of release
num_for_sale — Number of copies currently for sale on the marketplace
lowest_price — Lowest listed price for the release
currency — Price currency code
instance_id — Collection-specific instance identifier (for duplicate copies)
folder_id — Collection folder identifier
action — Sync action taken: add, remove, skip, or error

Release Matching

When using --artist and --album, the tool runs a multi-pass search to find the best Discogs match:

Structured search — artist, album, format, and year
Relaxed search — drops format and year constraints
Free text search — searches "artist album" as plain text

Each result is scored 0.0–1.0: 40% artist similarity + 40% title similarity + 10% year match + 10% format match. Results below --threshold (default 0.7) are rejected. Lower the threshold for fuzzy matches.

When using --master-id or --release-id, no search is needed — the ID is used directly.

Exit Codes

0 — Success (all items processed)
1 — Partial failure (some items failed)
2 — Complete failure (no items processed, or auth/config error)

Notes

Authentication supports personal access tokens (default) and OAuth 1.0a. Run python3 /home/claw/.openclaw/workspace/skills/discogs_sync/discogs-sync.py auth once.
The Discogs API is rate-limited to 60 requests/minute for authenticated users. The tool throttles automatically — no manual pacing needed.
Batch operations are resilient: individual item failures are collected and reported without aborting the entire batch.
Use --dry-run before any sync to preview what would change. This makes no API writes.
The --remove-extras flag on sync commands will remove items from your wantlist/collection that are not in the input file. Use with caution.
Collection allows multiple instances of the same release (e.g., two copies of the same LP). By default, collection add skips duplicates with a message. Use --allow-duplicate to add another copy.
Cache files are stored in ~/.discogs-sync/ alongside config.json: wantlist_cache.json, collection_cache.json, and marketplace_<type>_<hash>.json (plus …_details.json variants). Delete any of these files to manually clear a stale cache entry.
Credentials in ~/.discogs-sync/config.json contain your Discogs tokens. On Linux/macOS, restrict permissions: chmod 600 ~/.discogs-sync/config.json. Revoke tokens at https://www.discogs.com/settings/developers if compromised.

Files

SKILL.md and 19 other files in skills/discogs-sync of LeoYeAI/openclaw-master-skills.

SKILL.md
_meta.json
discogs-sync.py
pyproject.toml
requirements.txt
src/discogs_sync/__init__.py
src/discogs_sync/auth.py
src/discogs_sync/cache.py
src/discogs_sync/cli.py
src/discogs_sync/client_factory.py
src/discogs_sync/config.py
src/discogs_sync/exceptions.py
src/discogs_sync/marketplace.py
src/discogs_sync/models.py
src/discogs_sync/output.py
src/discogs_sync/parsers.py
src/discogs_sync/rate_limiter.py
src/discogs_sync/search.py
src/discogs_sync/sync_collection.py
… and 1 more

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Discogs Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Discogs Sync compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Discogs Sync this skillLeoYeAI/openclaw-master-skills	2.2k	—	~3.9k	Automated safety check: Pass	MIT	2 mo ago
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences	274	2 repos	~2.7k	Automated safety check: Pass	Apache-2.0	6 days ago
Sap Rpt1secondsky/sap-skills	462	—	~1.8k	Automated safety check: Notes	GPL-3.0	2 days ago
Replicate Paperbrycewang-stanford/Auto-Empirical-Research-Skills	4.5k	—	~1.9k	Automated safety check: Notes	Custom licence	2 days ago
Regression Insightrongxinzy/RongxinAI	154	—	~839	Automated safety check: Pass	MIT	today
Meta Forest Binary Plotaipoch/medical-research-skills	2k	—	~2.1k	Automated safety check: Pass	MIT	21 days ago

Similar skills

Instrument Data To Allotrope
aws-samples/amazon-bedrock-agents-healthcare-lifesciences
Official
Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.
274 GitHub starsUsed in 2 repos~2.7k tokens
Documents & OfficeAuto-check passed
Sap Rpt1
secondsky/sap-skills
SAP-RPT-1-OSS local tabular prediction workflows for FI/CO prototype datasets.
462 GitHub stars~1.8k tokensUpdated 2 days ago
Documents & OfficeAuto-check: notes
Replicate Paper
brycewang-stanford/Auto-Empirical-Research-Skills
Run a full 6-phase autonomous replication of a biomedical/epidemiology paper against UK Biobank or similar cohort data, producing Python and R scripts plus a validated replication report.
4.5k GitHub stars~1.9k tokensUpdated 2 days ago
Documents & OfficeAuto-check: notes
Regression Insight
rongxinzy/RongxinAI
对 CSV/Excel 数据执行线性回归（OLS）或逻辑回归（Logistic），一键输出完整统计结果（包含回归系数、R²、p值、VIF等）和中文通俗解读。当用户提及回归分析、拟合模型、查看系数显著性、R方、p值、共线性（VIF），或使用关键词如回归、regression、OLS、logit、拟合、显著性时触发。
154 GitHub stars~839 tokensUpdated today
Documents & OfficeAuto-check passed
Meta Forest Binary Plot
aipoch/medical-research-skills
Generate meta-analysis forest plots for binary classification data.
2k GitHub stars~2.1k tokensUpdated 21 days ago
Documents & OfficeAuto-check passed
CSV Pipeline
aAAaqwq/AGI-Super-Team
Process, transform, analyze, and report on CSV and JSON data files.
105 GitHub starsUsed in 1 repo~3.1k tokens
Documents & OfficeAuto-check passed

Questions about Discogs Sync

What does Discogs Sync do?

Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID. Discogs Sync is an agent skill from LeoYeAI/openclaw-master-skills. Add and remove albums from a Discogs wantlist or collection by artist and album name, master ID, or release ID.

When should I use Discogs Sync?

Discogs Sync fits situations like: the user asks to add; remove a record from their Discogs wantlist; check whats on their wantlist; look up marketplace prices.

How do I install Discogs Sync in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a claude-code`. Or copy the skill folder (skills/discogs-sync in LeoYeAI/openclaw-master-skills) into .claude/skills/discogs-sync in your project. Claude Code loads it when a task matches its description.

How do I install Discogs Sync in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a codex`. Or copy the skill folder (skills/discogs-sync in LeoYeAI/openclaw-master-skills) into .agents/skills/discogs-sync in your project. Codex loads it when a task matches its description.

Can I use Discogs Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill discogs-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/discogs-sync, .gemini/skills/discogs-sync, .github/skills/discogs-sync and .opencode/skills/discogs-sync in your project.

What does Discogs Sync need to run?

Going by SKILL.md and its folder, Discogs Sync needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pip). Our summary lists: Python 3.

Does Discogs Sync access the network?

SKILL.md names 1 domain. As links in the text: discogs.com. This is read from the text; nothing was executed.

Is Discogs Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Discogs Sync use?

Discogs Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discogs Sync use?

About 3.9k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Discogs Sync?

Skills that share tags, products or a category with Discogs Sync: Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Sap Rpt1 (secondsky/sap-skills, 462 stars), Replicate Paper (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and Regression Insight (rongxinzy/RongxinAI, 154 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discogs Sync?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,159 GitHub stars. The repository holds 972 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Discogs Sync

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Discogs Sync — Wantlist, Collection & Marketplace CLI

Runtime & Dependencies

Quick Start

Authentication

Usage

Wantlist — Add, Remove, List

Collection — Add, Remove, List

Marketplace — Search Pricing

Bulk Operations via File

Options

Output Format

Text (Default)

JSON (--output-format json)

Output Fields

Release Matching

Exit Codes

Notes

Files

Compare with similar skills

Similar skills

More from LeoYeAI/openclaw-master-skills

Related

Questions about Discogs Sync

JSON (`--output-format json`)