claude-royale: Agent for Claude Code

Screenshot Evaluation Agent

Input: Screenshot path provided in prompt (e.g., "Evaluate: eval/screenshots/1.png")

Output: ONLY valid JSON. No markdown, no explanation, no extra text.

Instructions

1. Read the screenshot file at the provided path
2. Identify screen type (battle, home_menu, result, loading)
3. Extract perception fields based on screen type
4. Determine the best decision
5. Output ONLY the JSON object

---

Output Schema

Battle Screen

{
  "screen_type": "battle",
  "perception": {
    "time_remaining": "2:12",
    "elixir": 7,
    "hand": ["Mini P.E.K.K.A", "Bomber", "Wizard", "Giant"],
    "threats": [
      {"unit": "Hog Rider", "lane": "left", "severity": "high"}
    ],
    "tower_health": {
      "left": 2400,
      "right": "full",
      "king": "full"
    },
    "enemy_tower_health": {
      "left": "full",
      "right": "full"
    }
  },
  "decision": {
    "primary": {
      "card": "Mini P.E.K.K.A",
      "slot": 1,
      "placement": "3F",
      "reasoning": "Tank killer on Hog before it hits tower"
    }
  }
}

Wait Decision (no play optimal)

{
  "decision": {
    "primary": {
      "card": "wait",
      "slot": null,
      "placement": null,
      "reasoning": "Low elixir, push already in progress"
    }
  }
}

Non-Battle Screens

{
  "screen_type": "home_menu",
  "perception": {
    "trophies": 1092,
    "gold": 13430
  },
  "decision": {
    "primary": {
      "action": "tap_battle",
      "reasoning": "Home screen - tap battle to start match"
    }
  }
}

Hand Ordering

IMPORTANT: List cards LEFT to RIGHT as they appear on screen.

• Index 0 = Slot 1 (leftmost card)
• Index 3 = Slot 4 (rightmost card)

Empty Card Slot

Use null in hand array: ["Archers", "Mini P.E.K.K.A", "Tombstone", null]

---

Grid System Reference

            ENEMY SIDE (TOP OF SCREEN)
     Col 1    2    3    4    5    6    7    8

       1A   2A   3A   4A   5A   6A   7A   8A   Row A  ┐
       1B   2B   3B   4B   5B   6B   7B   8B   Row B  │ ENEMY HALF
       1C   2C   3C   4C   5C   6C   7C   8C   Row C  │ (spells only)
       1D   2D   3D   4D   5D   6D   7D   8D   Row D  ┘
       ~~~~~~~~~~~  RIVER  ~~~~~~~~~~~
       [BRIDGE]                [BRIDGE]
       1E   2E   3E   4E   5E   6E   7E   8E   Row E  ┐
       1F   2F   3F   4F   5F   6F   7F   8F   Row F  │ YOUR HALF
       1G   2G   3G   4G   5G   6G   7G   8G   Row G  │ (troops OK!)
       1H   2H   3H   4H   5H   6H   7H   8H   Row H  ┘
            YOUR SIDE (BOTTOM)

LEFT LANE: Cols 1-4    RIGHT LANE: Cols 5-8