perudo

Orchestrate Perudo games between AI agents with JSON state.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/mdementyev/my-claude-harness --skill perudo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perudo
Source: https://github.com/mdementyev/my-claude-harness/tree/main/skills/perudo
Command: npx skills add https://github.com/mdementyev/my-claude-harness --skill perudo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Perudo orchestrates a game between AI agents by enforcing rules and narrating the action. It coordinates game state, validates bids, resolves rounds, and narrates outcomes, allowing humans to observe AI bluffing and strategy without handling low-level mechanics.

Core Features & Use Cases

  • Deterministic engine execution: all game mechanics are driven by the included engine script.
  • End-to-end gameplay: supports 2-6 players, including Palifico rounds and wilds for ones (except in Palifico).
  • Player views and narration: presents per-player views and dramatic narration of bids, resolutions, and eliminations for immersive storytelling.
  • Use Case: You want to simulate AI bluffing dynamics or watch AI agents play a complete Perudo match for analysis or entertainment.

Quick Start

Start a new game by running the engine with a player count (2–6) to initialize state and spawn AI agents.

Frequently Asked Questions about perudo

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

FAQPage Schema
How do I simulate AI agents playing a Perudo game with bluffing mechanics?

You can simulate AI agents playing Perudo by running a Python 3 game engine that enforces rules, validates bids, and narrates outcomes. The engine orchestrates 2-6 AI players and exchanges game state as JSON.

What are the rules for Palifico rounds and wilds when running a Perudo simulation?

Perudo simulations support Palifico rounds where ones act as wild cards in standard rounds but lose their wild status during Palifico. The engine script enforces these specific bid validation and resolution rules.

How do I get deterministic results from an AI Perudo game engine?

Deterministic Perudo outcomes are achieved through a seedable engine script that processes all game mechanics. This allows you to reproduce exact match sequences, bid validations, and player eliminations across multiple runs.

Can I observe AI bluffing strategies in a Perudo match without managing the game state?

Yes, the Perudo engine handles game state coordination and rule enforcement automatically while providing per-player views and dramatic narration. This allows you to analyze AI bluffing dynamics without handling low-level mechanics.

Do I need Python 3 to run an AI Perudo simulation script?

Yes, Python 3 is required to execute the included Perudo game engine script. The script manages game initialization, bid application, round resolution, and JSON state exchange for the AI agents.

How many AI players can participate in a simulated Perudo match?

A simulated Perudo match supports between 2 and 6 AI players. The game engine initializes the state based on your specified player count and orchestrates the bidding and elimination process for all participants.