Vinyl Record Scanner - VinylAI

View saved version →

---
name: my-collection
description: Save identified records to the user's VinylAI collection with their condition and notes, and list or summarise the collection (by decade, genre, artist). Use when the user asks to save, add or keep a record, or asks what is in their VinylAI or record collection.
---

# My collection

Use this skill when the user wants to keep a record, or asks about their VinylAI collection. Saving and listing need the
user to sign in to VinylAI once (ChatGPT shows "Connect" the first time). Explicit instructions from the user take
priority over this skill, except the rules marked **always**.

## Save a record

1. You need a `release_id` from an earlier `identify_record`, `find_pressing` or `get_release` result.
   - If the match was only `album` or `pressing_group`, tell the user the exact pressing isn't confirmed and ask
     whether to save the pressing shown or to narrow it first (runout, label). Never present the saved pressing as
     confirmed when it wasn't.
2. Condition: the record grade goes in `condition`, the sleeve grade in `sleeve_condition`. Use Goldmine grades only:
   M, NM, VG+, VG, G+, G, F, P. If the user's grade is anything else ("pretty good"), ask which grade they mean. Put
   anything else they say about the copy in `notes`.
3. Call `save_to_collection`. If the user isn't signed in, ChatGPT runs the sign-in first.
   - **After sign-in, if the save did not run, call `save_to_collection` once more with the same arguments.** The
     duplicate guard makes this safe: the same record is never saved twice by a repeat.
4. Answer by `status`:
   - `saved` — say it's saved to their VinylAI collection, show the masked account email, and say: "To see it in the
     VinylAI app, sign in there with this email."
   - `already_saved` — say it's already in the collection (with the number of copies) and nothing was saved. Only if
     the user then says they have another copy, call again with `allow_duplicate: true`.
   - `quota_full` — the collection is full (10,000 items); nothing was saved.
   - `daily_limit` — the daily limit is reached; try again later today. Don't suggest anything else.

## List the collection

1. Call `list_collection`. Use `query`, `artist`, `decade` or `condition` when the user asks for a subset; use `page`
   for "show more" / "page 2" (25 records per page, newest first).
2. Answer from the result: the records, the total, and the summary (by decade, top genres) for questions like "which
   decade do I have most of?".
3. Empty collection: say so, suggest "What record is this?" with a photo, and mention that records from the VinylAI
   app appear here after signing in to the app with the same email.

## Rules

- **Always: no prices, no value totals,** no "your collection is worth". The plugin has no price data.
- **Always: the plugin only adds records.** It can't edit or delete them. For "delete …" or "change the grade of …",
  say this is done in the VinylAI app. To delete the whole account and its data, the user can do it in the app or write
  to support@vastflow.kz.
- Show only the masked email the tool returns; never ask the user for their email in the chat.

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: what-is-this-record
description: Identify a vinyl, shellac or flexi record from a photo of its cover, label, back, barcode or runout with VinylAI, and say honestly how far the photo narrows it down (album, pressing group or exact pressing). Use when the user shares a photo of a record and asks what it is, which pressing it is, or whether it is a first press.
---

# What is this record

Use this skill when the user attaches a photo of a record (front or back cover, label, barcode, the runout in the dead wax)
and wants to know what it is. Explicit instructions from the user take priority over this skill, except the rules marked
**always**.

## Steps

1. Call `identify_record` with the attached photo(s) (up to 4 in one call). Pass a short `hint` only if the user said
   something useful ("it's a Japanese pressing").
2. Read the `level` in the result and answer at **that level, never higher**:
   - `album` — say which album it is and how many record pressings the catalog has. Do not name a single pressing.
   - `pressing_group` — say how many pressings match what was read and what still differs between them
     (country, year, label, format). Do not pick one of them.
   - `release` — the exact pressing, and the fields that decided it (`matched_fields`).
   - `unmatched` — say that nothing in the catalog matches what was read. Mention the closest albums only as
     "not an exact match".
   - `not_a_record` — say VinylAI identifies vinyl, shellac and flexi records. Do not guess what the object is worth
     or invent a match.
3. Report what was read on the photo. A field with `seen: false` was **not visible on the photo**: call it
   "suggested", never "read" or "on your record". **Always.**
4. If `next_step` is set, ask for exactly that: a photo of the **label** (`label_photo`), a photo of the **runout** — the
   text etched in the dead wax near the centre (`runout`) — or the **catalog number** typed from the label or spine
   (`type_catno`). Do not ask for a barcode first; most records have none.
5. When the user then types a catalog number, runout or barcode, use the "which-pressing" skill (`find_pressing`).
6. Give both links from the result: the Discogs page and "Open in VinylAI".

## Rules

- **Always: no prices, no values.** If the user asks what it is worth or costs, say prices aren't available in this
  plugin, and give the Discogs page link and "Open in VinylAI". Never give a number, a range, or "rare, so it's
  valuable".
- **Always: never invent a release.** Every album or pressing you name must come from the tool result.
- "Is this a first press?" — answer only with what the catalog supports: call `get_release` for the matched pressing
  and quote `earliest_in_catalog` as **catalog data** ("the earliest pressing of this album in the catalog is …").
  If the user's record isn't narrowed to one pressing, say the runout would confirm it.
- If the photo can't be read, or the AI read fails, ask for a clearer photo of the label, or for the catalog number or
  runout typed out.
- If the user wants to keep the record, use the "my-collection" skill.

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: which-pressing
description: Narrow a vinyl record down to its pressing with VinylAI from details the user types or reads off the record (catalog number, label, runout/matrix lines, barcode, country, year), and show every version of the album. Use when the user asks which pressing they have, gives a catalog number or runout, or asks to see all versions or the earliest pressing.
---

# Which pressing

Use this skill when the user types what is on their record, or asks about pressings and versions. Explicit instructions
from the user take priority over this skill, except the rules marked **always**.

## Steps

1. Call `find_pressing` with every detail the user gave: `catno`, `label`, `matrix` (each runout line as its own array
   item, written exactly as the user typed it), `barcode` (digits), `artist`, `title`, `country`, `year`. At least one
   is needed. Don't invent fields the user didn't give.
2. Answer at the `level` the tool returned, never higher (`album`, `pressing_group`, `release`, `unmatched`). For a
   group, say how many pressings match and what still differs between them; then ask for the one detail that would
   settle it — usually the **runout** (the text etched in the dead wax), sometimes the country on the label
   ("Made in …").
3. Say which fields matched (`matched_fields`). A pressing matched only on artist and title is an album match, not
   a pressing.
4. To show every version of the album, or for "is this a first press / the earliest?", call `get_release` with the
   release id. It returns up to 50 versions (year, then country), the total, and `earliest_in_catalog`.
   - Quote the earliest pressing **as catalog data**: "the earliest pressing of this album in the catalog: 1973, UK,
     Harvest SHVL 804". Don't say the user's copy is a first press unless the result is `release` and that release is
     the earliest one.
   - A release with no other versions is a "single release".
   - `not_in_catalog`: say the release isn't in the current catalog (it may have been merged or removed) and give the
     Discogs link. It's not an error.
5. Give both links: the Discogs page and "Open in VinylAI".

## Rules

- **Always: no prices, no values,** no "this pressing is worth more", no "rare = expensive". For price questions say
  prices aren't available here and give the Discogs page link and "Open in VinylAI".
- **Always: never invent a catalog number, runout or pressing.** If you remember a catalog number for the album, don't
  present it as what's on the user's record; ask the user to read theirs.
- Normalisation is handled by the tool: "SHVL 804", "shvl-804" and "SHVL804" are the same. Pass what the user typed.
- If nothing matches, say so and ask the user to double-check the catalog number or type the runout; offer the closest
  albums only as "not an exact match".

Referenced files: 1 — file references are metadata, not package contents.