MTG Wiki (English)

万智牌全知识库助手。用于回答万智牌规则问题、查询中英文牌张、分析牌张互动、解释赛制与策略、讲述背景故事。当用户询问万智牌相关内容（牌名、规则概念、赛制、策略、背景设定）或调用 /mtg-wiki 时触发。

Install

openclaw skills install @raymondeeeemmmm/mtg-wiki-en

MTG Wiki — Magic: The Gathering Knowledge Base Assistant

Overview

Your all-in-one Magic: The Gathering companion covering rules, card lookup, interactions, formats, strategies, and lore. Powered by a local knowledge base including ~187 wiki pages, 37,230-card Oracle database, and complete bilingual CR/MTR/IPG rule documents.

Knowledge Base Structure

Directory	Contents
`wiki/concepts/`	Rule concepts, mechanics, strategies (~174 pages)
`wiki/entities/`	Characters, organizations, products
`wiki/sources/`	Source document summaries
`wiki/synthesis/`	Comparative analysis
`raw/cr/`	Complete Comprehensive Rules (bilingual)
`raw/mtr/`	Magic Tournament Rules
`raw/ipg/`	Infraction Procedure Guide

Core Capabilities

1. Rules Lookup (CR/MTR/IPG)

Triggered by: "how does first strike + deathtouch work", "stack resolution order", "layer system"

Workflow:

Read relevant concept pages in wiki/concepts/
For precise rules text, use rule_search.py to search the local rules index
Cite exact rule numbers (e.g., CR 510.4, CR 613.6)

Key rules quick reference:

Layer system: CR 613 (copy → control → text → type → color → abilities → P/T)
APNAP: CR 101.4 (active player decides first)
Stack: CR 405 (LIFO)
State-based actions: CR 704 (automatic, don't use the stack)

2. Card Lookup (Chinese & English Fuzzy Search)

Triggered by: user mentions a card name (in either language, fuzzy, or slang)

Workflow:

Call card_search.py for unified search
Return bilingual card info (name, mana cost, type, rules text, format legality)

Card name format:

First mention: Chinese Name (English Name)
Subsequent mentions: Chinese Name

3. Card Interaction Analysis

Triggered by: user describes a multi-card scenario ("what happens if...")

Analysis framework:

Layer determination: identify which layer each effect belongs to → check for cross-layer (613.6) or dependency (613.8)
Stack resolution: APNAP order → LIFO
Zone determination: "permanent" (battlefield only) vs "spell" (stack only)

4. Strategy & Format Analysis

Triggered by: user discusses deck archetypes, format selection, banned/restricted lists

Format pages: standard.md / pioneer.md / modern.md / legacy.md / vintage.md Commander: commander.md / cedh.md

5. Article Translation

When translating MTG deck guides or strategy articles:

Extract card names, use name_translator.py for official Chinese translations
Standardize terminology
Output Markdown with card name reference table and terminology glossary

Tools

bash

# Card lookup (supports Chinese/English fuzzy search)
python3 ./raw/tools/mtg_wiki/card_search.py "Lightning Bolt"
python3 ./raw/tools/mtg_wiki/card_search.py "闪电击"

# Rules lookup (by rule number or keyword)
python3 ./raw/tools/mtg_wiki/rule_search.py "101.4"
python3 ./raw/tools/mtg_wiki/rule_search.py "stack"

# Name translation (EN↔CN)
python3 ./raw/tools/mtg_wiki/name_translator.py "Lightning Bolt"

API priority:

mtgch API (https://mtgch.com/api/v1/) — Chinese first, bilingual
Scryfall API (https://api.scryfall.com/) — English primary
Local 37k Oracle DB — offline exact match

Layer System Quick Reference (CR 613)

Layer	Effect	Example
1	Copy effects	Clone
2	Control-changing	Betray
3	Text-changing	Alter Reality
4	Type-changing	Blood Moon vs. Urborg
5	Color-changing	Sleight of Mind
6	Add/Remove abilities	Tidebinder / Suppression Field
7	Power/Toughness	Various +/- P/T

Key distinctions:

Cross-layer effects (613.6): different parts of the same effect apply in different layers independently, even if the source ability disappears
Dependency (613.8): only exists when effects are in the same layer

Turn Structure

text

Untap → Upkeep → Draw → Precombat Main → Combat → Postcombat Main → End

APNAP (CR 101.4):

Active player decides first, non-active player decides later
Multiple triggered abilities go on stack simultaneously via APNAP
Result: non-active player's triggers resolve last (LIFO within APNAP)

Answering Standards

Prefer wiki citations: check wiki/concepts/ first for relevant pages
Precise rule citations: cite CR/MTR rule numbers, don't answer from memory
Bilingual card names: use Chinese (English) format
Cross-links: include [[slug|display]] references

Complete Rule Files

File	Contents
`raw/cr/1.md`	Game concepts, priority, costs
`raw/cr/6.md`	Spells, abilities, layer system (613)
`raw/cr/7.md`	Keyword abilities (702), keyword actions (701)
`raw/cr/glossarycn.md`	Chinese terminology glossary

For Judges

Decision trees: wiki/branches/referee/decision-trees/ Analysis frameworks: wiki/branches/referee/frameworks/

Judge rules questions must:

Decompose by timeline and mechanics
Force deep search of keyword actions (check CR 702)
Four-step rule text reading: copy fully → circle qualifiers → verify each word → reverse-validate
Output compliance report

Full Knowledge Base

This published skill contains only the core code. For the complete ~187 wiki pages + 37,230 card database + bilingual CR/MTR/IPG rules (~13MB), clone the full repository: