ygo-card-research

Query the Yu-Gi-Oh cards.cdb database and analyze card scripts and effects.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/ZisIsNotZis/ygoskill --skill ygo-card-research-zisisnotzis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ygo-card-research
Source: https://github.com/ZisIsNotZis/ygoskill/tree/main/ygo/card-research
Command: npx skills add https://github.com/ZisIsNotZis/ygoskill --skill ygo-card-research-zisisnotzis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding accurate Yu-Gi-Oh card information—exact stats, archetype membership, and effect behavior—requires digging through databases and Lua scripts manually, which is slow and error-prone. ## Core Features & Use Cases - Database Queries: Run sqlite3 queries against cards.cdb for exact-name, partial-name, setcode, and type-bitmask lookups. - Card Info Display: Use ydkshow.py to print full card details including id, type, level, attribute, race, ATK/DEF, and effect text. - Script Analysis: Read c<ID>.lua script files to understand actual effect implementation, trigger conditions, costs, and restrictions beyond the printed text. - Use Case: A user asks "find all hand traps that negate monster effects"—the workflow maps the natural-language request to CATEGORY flags, greps script files, and returns matching cards with structured output. ## Quick Start Look up the card Ash Blossom & Joyous Spring and summarize its effect, stats, and meta relevance.

Frequently Asked Questions about ygo-card-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up a Yu-Gi-Oh card by name in cards.cdb?▼

Query the datas and texts tables joined on id using sqlite3 with a WHERE clause on t.name. Exact matches use equality, while partial matches use LIKE with %keyword% wildcards.

How to find all cards of a Yu-Gi-Oh archetype in the database?▼

Filter by setcode, checking all four 16-bit fields of the 64-bit setcode integer with bitmask shifts. The query tests setcode&0xFFFF, (setcode>>16)&0xFFFF, (setcode>>32)&0xFFFF, and (setcode>>48)&0xFFFF against the archetype code.

Can I search Yu-Gi-Oh cards by effect function like negate or search?▼

Yes, map the natural-language description to CATEGORY flags such as CATEGORY_NEGATE or CATEGORY_TOHAND+CATEGORY_SEARCH, then grep the script/c*.lua files for those flags to find matching cards.

What if a card is not in the local cards.cdb database?▼

For recently printed or missing cards, fall back to online research: search the Yu-Gi-Oh wiki for card info, community forums for competitive reviews, and ruling databases for clarifications.

Why read the Lua script when the database already has effect text?▼

The database text is the printed description, while the c<ID>.lua script reveals actual implementation details like trigger conditions, costs, targets, resolution order, and once-per-turn restrictions.