oracle-parser

Document nom-based MTG Oracle parsing rules and priority workflow.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gamajose/MagicTheGathering --skill oracle-parser-gamajose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oracle-parser
Source: https://github.com/gamajose/MagicTheGathering/tree/main/.claude/skills/oracle-parser
Command: npx skills add https://github.com/gamajose/MagicTheGathering --skill oracle-parser-gamajose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes MTG Oracle parsing knowledge to avoid divergent implementations and inconsistent behavior across the codebase.

Core Features & Use Cases

  • Canonical Oracle parsing rules and nom-based architecture
  • Priority-based parse workflow and modular architecture
  • Central reference for parser helpers, AST lowering, and contribution checklists

Quick Start

Consult this reference when implementing a new Oracle parser rule or updating the parser workflow.

Frequently Asked Questions about oracle-parser

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

FAQPage Schema
How do I parse MTG Oracle text consistently across a codebase?

To parse MTG Oracle text consistently, consult a centralized reference providing canonical parsing rules and nom-based architecture to prevent divergent implementations. This ensures uniform behavior across all card text processing.

What is the nom-based parser architecture for MTG card texts?

The nom-based parser architecture for MTG card texts uses a modular design with a priority-based parse workflow. It provides parser helpers and AST lowering rules to structure and interpret Oracle text accurately.

How do I implement a new Oracle parser rule for MTG cards?

To implement a new Oracle parser rule, follow the documented contribution checklists and priority-based parse workflow. Consult the central reference to align your rule with the existing modular architecture.

Why do I need a priority system in an MTG Oracle parser?

A priority system in an MTG Oracle parser manages the sequence of rule application to resolve overlapping card text patterns consistently. This prevents conflicting parse outputs across the codebase.

Does this MTG Oracle parser reference include AST lowering guidelines?

Yes, the MTG Oracle parser reference includes AST lowering guidelines. It serves as a central resource for parser helpers and lowering rules to transform parsed text into structured data.

What are the limitations of using a centralized MTG Oracle parser reference?

The limitation of a centralized MTG Oracle parser reference is that it requires strict adherence to its contribution guidelines and priority system. Deviating from the nom-based architecture may reintroduce inconsistent parsing behavior.