MTG Skills
Claude Code skills for Magic: The Gathering.
Installation
npx skills add dan-blanchard/mtg-skills
Available Skills
deck-wizard
Build MTG decks from scratch or tune existing ones across all formats — Commander/EDH, Brawl, Historic Brawl, Standard, Alchemy, Historic, Pioneer, Timeless, Modern, PreModern, Legacy, and Vintage. Two-phase workflow: Phase 1 acquires a deck (parse an existing list or build from scratch via interview + research + skeleton generation), Phase 2 runs a 12-step tuning pipeline with mana auditing, combo detection, archetype coherence analysis, a two-agent debate, and impact verification.
cube-wizard
Build and tune MTG cubes — curated card pools designed for drafting. Supports Vintage, Unpowered, Legacy, Modern, Pauper, Peasant, Set, Commander, and PDH cubes. Two-phase workflow: Phase 1 acquires a cube (parse an existing CubeCobra cube or clone a well-known reference cube), Phase 2 runs a 9-step tuning pipeline covering designer intent, balance dashboards, archetype signal density, power-level review, a two-agent self-grill, cube-diff impact verification, pack simulation, and CubeCobra CSV export.
lgs-search
Search The Gathering Place + Atomic Empire (LGS) and TCGPlayer + Mana Pool (online) for an MTG card list, allocate to minimize total cost, and hand off pre-loaded headed browser windows for checkout. Targets at most three carts: TGP, AE, and one of TCGPlayer or Mana Pool.
rules-lawyer
Answer MTG rules questions by citing the actual Comprehensive Rules and Scryfall per-card rulings — the project's legal database (CR = statute, Scryfall rulings = case law). Resolves keyword interactions, trigger timing, replacement-effect layer issues, and stack-order questions with authoritative citations. Usable standalone or invoked by deck-wizard / cube-wizard / deck-strat via the Skill tool. Iron Rule: every answer cites at least one specific CR rule number from CLI output, never paraphrased from training data.
deck-strat
Generate a Strategy Guide for a finished Commander, Brawl, or Historic Brawl deck — a markdown document that explains how to pilot the deck, organized into a fixed core spine plus archetype-conditional sections (politics, voltron, combo execution, aristocrats, token doubling). Every rules-adjacent claim is verified against the Comprehensive Rules via a parallel Rules Audit pass. Read-only on the deck (no cuts/adds); for tuning, run /deck-wizard first, then /deck-strat on the finished list.
proxy-printer
Render printable PDF proxies from a parsed deck JSON. proxy-print --kind cards emits one proxy per copy of every card in the deck; proxy-print --kind tokens emits one proxy per distinct token kind those cards produce (deduped by Scryfall oracle_id). Both modes share one render template — name banner / ASCII art / type banner / oracle text / P/T — with art keyed by card subtype from a hand-curated local catalog plus an optional attributed catalog populated by fetch-art (mines asciiart.eu + asciiart.website). Callable standalone or at the end of a deck-wizard / cube-wizard build session.
twohg-guide
Build a Two-Headed Giant prerelease cheat sheet for a new set: what's winning (Untapped.gg Arena Early Access stats merged with paper prerelease reports from saved Reddit threads), team pairings, every card that hits twice against two opponents, the symmetric effects that also hit your partner, the 2HG rules that change games (with Comprehensive Rules citations), bombs and removal (your pile and theirs), and a build-hour checklist. Published as a private claude.ai page where hovering a card name shows the card.
Tooling
All skills share CLI scripts via the mtg_utils package (mtg-utils/).
Deck tooling
- parse-deck — Multi-format deck list parser with sideboard support
- scryfall-lookup — Card lookup against local Scryfall bulk data with API fallback
- card-search — Search bulk data with filters: format legality, oracle text, type, CMC, price
- combo-search / combo-discover — Commander Spellbook API for combo detection and discovery
- legality-audit — Format legality, copy limits (singleton or 4-of), sideboard size, Vintage restricted
- mana-audit — Land count formulas (Burgess for commander, constructed formula for 60-card) and color balance
- build-deck — Apply mainboard and sideboard cuts/adds
- price-check — USD pricing or Arena wildcard budgeting
- deck-stats — Deck statistics with sideboard reporting
- deck-diff — Compare deck versions including sideboards
- export-deck — Moxfield/Arena import format with sideboard section
- card-summary — Compact card table with sideboard display
- edhrec-lookup — EDHREC JSON endpoint client (commander skills only)
- cut-check — Mechanical pre-grill for commander trigger/synergy analysis
- mark-owned — Collection intersection with Arena name aliasing
- mtga-import — Extract Arena collection and wildcard counts
Cube tooling
- cubecobra-fetch — Pull a cube from CubeCobra (
cubeJSON → cubelist → CSV fallback, with curl fallback for 403s)
- parse-cube — Parse CubeCobra JSON / CubeCobra CSV / plain text / deck JSON into canonical cube JSON
- cube-stats — Informational metrics: size, per-color distribution, curve, types, rarity, commander pool by color identity
- cube-balance — Informational checks (not pass/fail) for color balance, curve, removal density, fixing density, and commander-pool composition
- cube-legality-audit — Hard-constraint validation: rarity filters (Pauper, Peasant, PDH), format legality, ban list, commander-pool rarity
- archetype-audit — Cross-reference user-supplied theme regexes against color pairs; surface bridge cards and orphan signals
- cube-diff — Compare two cube revisions with optional balance-metric deltas
- pack-simulate — Seeded pack generation (sizes 9/11/15) with configurable slot templates; optional dedicated commander packs
- export-cube — Export canonical cube JSON to CubeCobra-compatible CSV (for the "Replace with CSV Import" round-trip) or plain text
2HG guide tooling
- twohg-scan — Classify a set's cards for Two-Headed Giant: ×2 cards, partner hits, per-head vs once-per-step triggers (CR 805.4d), removal that can hit planeswalkers
- limited-stats — Untapped.gg MTGA limited stats: colour-pair win rates, best commons, bomb candidates, underperformers
- thread-extract — Turn a browser-saved Reddit thread into comments and deck-photo paths
- guide-card-hovers / twohg-template — The cheat-sheet template, and card-image hovers for a finished sheet
Supported Deck Formats
| Format | Deck Size | Copy Limit | Sideboard | Platform |
|---|
| Commander/EDH | 100 | Singleton | No | Paper |
| Brawl (Standard Brawl on Arena) | 60 | Singleton | No | Arena + Paper |
| Historic Brawl (Brawl on Arena) | 60 or 100 | Singleton | No | Arena + Paper |
| Standard | 60 | 4-of | 15 | Arena + Paper |
| Alchemy | 60 | 4-of | 15 | Arena |
| Historic | 60 | 4-of | 15 | Arena |
| Timeless | 60 | 4-of | 15 | Arena |
| Pioneer | 60 | 4-of | 15 | Paper + Arena |
| Modern | 60 | 4-of | 15 | Paper |
| PreModern | 60 | 4-of | 15 | Paper + MTGO |
| Legacy | 60 | 4-of | 15 | Paper |
| Vintage | 60 | 4-of (restricted=1) | 15 | Paper |
Supported Cube Formats
| Format | Default Size | Card Pool | Rarity Filter | Commander Pool |
|---|
| vintage | 540 | Full eternal | — | No |
| unpowered | 540 | Full eternal (Power 9 banned) | — | No |
| legacy | 540 | Legacy-legal | — | No |
| modern | 540 | Modern-legal | — | No |
| pauper | 540 | Full eternal | Commons only | No |
| peasant | 540 | Full eternal | Commons + uncommons | No |
| set | 360 | Single set | — | No |
| commander | 540 | Commander-legal | — | Yes |
| pdh | 540 | Full eternal | Commons (main) | Yes (uncommons) |
Prerequisites
On first use, the skill runs uv sync to install Python dependencies and downloads Scryfall bulk data (~500MB).
License
0BSD
