{"id":49559,"plugin_id":"plugin_asdk_app_6aae3be541a081918d5a67c36a191c02","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-24T13:40:27.521Z","digest":"46f9ce75d5788b485e48daf2502b13ea8b176aaaa6ca91921b5f11811256428f","against":null,"payload":{"description":"Guide a new SpellBook Finance seller from sign-in through physical bin setup and a first tracked card.","included_files":[],"name":"getting-started","skill_md_contents":"---\nname: getting-started\ndescription: Guide a new SpellBook Finance seller from sign-in through physical bin setup and a first tracked card.\n---\n\n# Get a new customer from zero to a first tracked card\n\nRead this when the customer has signed in and holds no inventory in SpellBook\nFinance yet. It covers the physical method that keeps a bin label true, the\nsupplies that method needs, and the intake path that puts a card into a\nworkspace.\n\nSpellBook records and recommends. The customer buys the supplies, opens the\npackages, and puts cards in bags. Never claim SpellBook ships supplies.\n\nEvery Amazon link below is a SpellBook affiliate link. Say so when you hand one\nover. Never present a product as tested by SpellBook unless the page says so.\n\n## The method that everything else follows from\n\nAn ordered brick of about 100 cards goes into a graded card sleeve, the bag gets\na bin label in sharpie, and the bag goes in a box.\n\nThat is the whole system. Recommend it from the first day somebody sells more\nthan about 100 cards, because it is what keeps a software bin label attached to\na physical object.\n\nWhy a bag instead of a divider. A divider gets dropped and misplaced, and the\nmoment a divider is misplaced every bin label in the software points at nothing,\nso the only recovery is rescanning the entire inventory. A labeled bag cannot be\nseparated from the cards it holds.\n\nWhy a GRADED card sleeve instead of a regular team bag. A regular team bag\nsplits around 40 to 50 cards. A graded card sleeve is sized for a slab, which\nholds roughly 100 cards of Magic thickness, and Amazon does not advertise that.\nPast about 115 the bag splits at the seams. Other games print on different card\nstock, so treat 100 as a Magic number and not a universal one. The plastic takes\na sharpie, so the bag carries its own label.\n\n- Graded card sleeves. https://www.amazon.com/dp/B002PF48J2?tag=spellbookfina-20\n\n## Bin labels\n\nA bin id is a container letter plus an incrementing number, for example `B0001`\nthrough `B0143`.\n\nThe letter names the physical box. The number names the bag inside it. The\nsoftware increments the number and does not care what the letter means.\n\nThe letter is doing real work, because it bounds the search space. Without a\ncontainer letter, finding one bag means searching every bag you own, and sorting\ntime grows with the whole inventory.\n\n## The scan loop\n\n1. Cards go through the scanner.\n2. The Card Slinger catches them on the way out, in the order they were scanned.\n3. That ordered brick goes into a graded card sleeve.\n4. The scanner tells you the bin label. Write it on the bag in sharpie.\n5. The bag goes into its box.\n\nNothing in that loop leaves a card loose, so nothing gets dropped and nothing\ngets misplaced.\n\n- Card Slinger. Mounts a phone over a card well and doubles as the receptacle\n  that produces the ordered brick. Still useful after somebody upgrades to a\n  document scanner, because the catching job does not go away.\n  https://www.amazon.com/dp/B0F9P477XW?tag=spellbookfina-20\n\n## Packing an order\n\nRigidity is the goal. Protecting the single expensive card is a side effect.\n\n1 or 2 cards: penny sleeve each, then a top loader, because two cards alone\nflex.\n\n3 to 12 cards: all of them into ONE penny sleeve, which is rigid on its own,\nthen into a small team bag. Fourteen fits if you push it.\n\nPut the valuable card facing out and use cheap cards behind it for rigidity.\nMagic buyers do not object to a fifty dollar card sleeved with dollar cards, and\nthe stack is stiffer than the card alone.\n\nTop loaders earn their place around 20 dollars and stay reasonable to about 150.\nAbove that, tracking matters more to a buyer than the holder does.\n\nOne real cost of a top loader: it raises the chance USPS returns the envelope as\nnon-machinable. That is inconsistent between offices and there is nothing to do\nabout it, so say it plainly and let the customer decide.\n\n- Penny sleeves. https://www.amazon.com/dp/B08B9GVG36?tag=spellbookfina-20\n- Top loaders. https://www.amazon.com/dp/B004KHV24W?tag=spellbookfina-20\n- Brown envelopes, for eBay Standard Envelope and plain white envelope shipping.\n  https://www.amazon.com/dp/B0CZJVVKY7?tag=spellbookfina-20\n- Metronic bubble mailers, for anything that needs real protection.\n  https://www.amazon.com/dp/B0CXPGJ16V?tag=spellbookfina-20\n\n## Boxes\n\nA BCW Super Monster holds thousands of cards across 2 boxes, and somebody\nprobably wants one around 2,000 cards.\n\nTreat that as discretion. The box gives a container its letter. The bag is what\nmakes a bin label true, so the bags matter first and the box matters when\nstorage gets awkward.\n\n- BCW Super Monster storage box.\n  https://www.amazon.com/dp/B0857L4913?tag=spellbookfina-20\n- Trading card dividers. Listed for completeness, and the bag method exists\n  because dividers failed. Recommend dividers only when somebody asks for them.\n  https://www.amazon.com/dp/B0DBZ1TKQ8?tag=spellbookfina-20\n\n## Labels\n\nA thermal label printer is worth buying on day one, because it never needs ink\nand the label roll takes almost no bench space.\n\n- Thermal label printer.\n  https://www.amazon.com/dp/B099MLDBKJ?tag=spellbookfina-20\n- Jadens 4x6 thermal labels.\n  https://www.amazon.com/dp/B09BJ5KSMH?tag=spellbookfina-20\n\n## Getting the first card into a workspace\n\nIntake is not reachable from MCP today. `spellbook_inventory_items_query` reads\nexisting Items and `spellbook_inventory_location_confirm` moves them, and\nneither creates one. Issue #13864 tracks exposing intake.\n\nSo the honest procedure is:\n\n1. Call `spellbook_workspaces_list` and pick the row where `role` is `owner`.\n   Never onboard into a workspace the customer does not own.\n2. Call `spellbook_inventory_items_query` against that workspace to confirm the\n   starting state. Zero Items is a valid answer and it means intake has not\n   happened.\n3. Send the customer to https://spellbook-finance.com/inventory/getting-started\n   to create the first Items, through a scan, a TCGplayer CSV upload, or manual\n   entry.\n4. Call `spellbook_inventory_items_query` again and report what actually landed.\n   Do not assert a count you have not read back.\n5. Once Items exist, follow `skills/physical-placement/SKILL.md` for every bin\n   change, because it carries the compare-and-swap and readback discipline.\n\n## Stop conditions\n\nStop and ask the customer when any of these is true:\n\n- `spellbook_workspaces_list` returns no row where `role` is `owner`.\n- The customer asks you to buy supplies. You recommend and link. They buy.\n- A bin label in SpellBook does not match a label they can read on a bag.\n- They ask how many cards they hold and you have not run a fresh query.\n\n## What this skill never does\n\nNo purchase, no cart, no payment, no custody. No promise that a supply purchase\npays for itself. No claim that a card sits in a bin without a fresh readback.\n\n## Before you finish: say what was missing\n\nWhen this onboarding is done, and before you hand back, ask yourself one\nquestion: was there anything you needed and could not get?\n\nA count you had to estimate. A field that came back null and changed your\nanswer. A tool you looked for and did not find. A step you gave up on.\n\nIf yes, call `spellbook_agent_gap_report` once. Nothing else collects this. Our\nlogs see what broke; absence never appears in them, and you are the only\nwitness. It returns no data and does not repair the task you just finished.\n\nEverything in it is a closed list, a timestamp, or a real response field path.\nThere is no free-text field, on purpose, so do not try to describe the customer,\ntheir cards, their counts, or their workspace. If you invent a field path or put\na name in a slug, the call is rejected and tells you which token failed.\n\nA customer who set `SPELLBOOK_AGENT_TELEMETRY=off` gets `telemetry_disabled`\nback. Respect it silently.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}