add-keyword

Add or modify keyword abilities in the MTG engine.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill documents how to add or modify keyword abilities in the MTG engine, including evergreen keywords, parameterized keywords, and protection variants, ensuring runtime behavior is wired into combat, targeting, damage, or triggers.

Core Features & Use Cases

  • Design and integrate new Keyword variants into the engine, including parsing, serialization, and runtime checks.
  • Align keyword behavior across combat, targeting, and state-based actions with tests and synthesis.
  • Use Case: When adding Ward or Kicker to a creature, update parsing and evaluation so the engine recognizes and enforces the behavior.

Quick Start

Create a new keyword by updating the engine's Keyword enum, parsing logic, and relevant checks, then run the engine tests.

Frequently Asked Questions about add-keyword

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

FAQPage Schema
How do I add a new keyword ability to an MTG engine?

Adding keyword abilities to the MTG engine requires updating the Keyword enum, its FromStr and keyword_from_tagged parsing implementations, and wiring integration points across combat, targeting, and state-based action modules.

What is needed to implement parameterized keywords like Ward or Kicker in Magic engine design?

Implementing parameterized keywords like Ward or Kicker requires updating the parsing logic and runtime evaluation so the MTG engine recognizes and enforces the behavior across combat, targeting, and triggers.

How do I parse JSON tagged keywords for a game engine?

Parsing JSON tagged keywords involves updating the keyword_from_tagged implementations in the engine to correctly deserialize and map tagged data into the corresponding Keyword enum variants for runtime use.

Where do I wire evergreen keyword behaviors for combat and targeting checks?

Evergreen keyword behaviors are wired into the combat, targeting, and state-based actions (sba) modules, ensuring the engine enforces abilities consistently during runtime checks and interactions.

Does adding a keyword variant require updating state-based actions?

Yes, adding a keyword variant requires updating the state-based actions (sba) module to ensure the new ability's runtime behavior is correctly enforced alongside combat and targeting checks.