Game Logic

Implement, test, and maintain game logic for Hearts, King, Spades, and Okey101.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kerem-ersoz/gonul --skill game-logic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Game Logic
Source: https://github.com/kerem-ersoz/gonul/tree/main/.github/skills/game-logic
Command: npx skills add https://github.com/kerem-ersoz/gonul --skill game-logic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, spec-driven framework for implementing, debugging, and maintaining game logic across four Turkish card/tile games (Hearts, King, Spades, and Okey101), ensuring consistent rules, phase flows, and scoring.

Core Features & Use Cases

  • Centralized specifications for Hearts, King, Spades, and Okey101 with dedicated game classes and shared utilities.
  • Phase-driven state management and rigorous move validation to guarantee correct round lifecycles and scoring.
  • Reusable data types, helpers, and references to ensure engineers can extend or modify rules while staying aligned with the official specs.

Quick Start

Consult the SPECIFICATION files and the corresponding server/games implementations to begin exploring or updating the logic for all four games.

Frequently Asked Questions about Game Logic

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

FAQPage Schema
How do I implement game logic and scoring rules for Turkish card games like Okey101?

To implement Turkish card game logic, use this specification-driven framework which provides dedicated game classes, shared utilities, and strict phase-driven state management for Okey101, Hearts, King, and Spades to ensure correct scoring and round lifecycles.

What is phase-driven state management and how does it help maintain card game rules?

Phase-driven state management enforces rigorous move validation and round lifecycles by controlling game phase transitions. It ensures card game rules remain aligned with official specifications while preventing invalid moves during complex gameplay states.

Can I extend or modify scoring rules for Hearts and King without breaking existing game logic?

Yes, you can modify scoring rules and game logic using reusable data types and shared utilities. The specification-driven framework ensures extensions remain aligned with official specifications while maintaining strict phase flow and move validation across all four card games.

How do I start debugging or validating game phases and rules across multiple card games?

Start debugging card game rules by consulting the SPECIFICATION files alongside server and game implementations. The centralized framework provides shared utilities and references to validate phase flows, scoring, and move logic across Hearts, King, Spades, and Okey101.

Does this game logic framework work for tile-based games or only standard card games?

The framework supports both card and tile games, specifically covering Turkish variants including Okey101 which uses tiles. It applies centralized specifications, phase-driven state management, and scoring validation to maintain correct rules across all four included games.