.codex-plugin/plugin.json

{
  "name": "math-cages",
  "version": "1.0.0",
  "description": "Printable math cage puzzles with one solution and an answer key.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://math-cages.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "math cage puzzles",
    "arithmetic puzzles",
    "math logic puzzles",
    "printable math puzzles",
    "math puzzle worksheet",
    "cage puzzle generator",
    "math puzzles with answer key",
    "mental math puzzles",
    "number logic puzzles"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Math Cages",
    "shortDescription": "Printable math cage puzzles",
    "longDescription": "Make printable math cage puzzles for teachers, students and puzzle fans as a PDF with an answer key. Zovo Math Cages builds arithmetic cage puzzles from 4 x 4 to 9 x 9: fill each row and column with the numbers 1 to N once, and make each outlined cage reach its target with its sign.\n\nChoose the operations the class is practising: addition only, addition and subtraction, multiplication and division, or all four. Subtraction and division cages have 2 cells. Pick easy, medium or hard; harder puzzles have bigger cages and fewer single-number cells.\n\nBefore the PDF is made, a solver checks that each puzzle has one solution. The reply lists each puzzle with its size, number of cages, single-number cells and the solver steps it took, as a rough difficulty signal.\n\nThe PDF puts 1, 2 or 4 puzzles on each page, on US Letter or A4, with an optional title and a name and date line for worksheets. Cages have thick borders with the target and sign in the corner. Answer pages at the end show each solved grid in the same place. Up to 12 puzzles fit in one PDF.\n\nEach puzzle has a seed. The same seed and settings give the same puzzle again, so a teacher can reprint a sheet next term.\n\nLimitations: grids are square from 4 x 4 to 9 x 9 with the numbers 1 to N (no zero and no larger numbers), puzzles with only subtraction or division have many single-number cells, it does not solve a puzzle from a photo, and titles print in Latin, Greek and Cyrillic letters (Chinese, Japanese, Korean, Arabic, Hebrew and emoji are left out of the PDF).",
    "developerName": "Zovo",
    "category": "Education & Research",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://math-cages.zovo.one",
    "supportURL": "https://math-cages.zovo.one/support",
    "privacyPolicyURL": "https://math-cages.zovo.one/privacy",
    "termsOfServiceURL": "https://math-cages.zovo.one/terms",
    "defaultPrompt": [
      "Make 4 easy 4x4 math cage puzzles with addition only, 2 per page, titled Number Fun, seed 11",
      "Make a hard 6x6 math cage puzzle with all four operations on A4, seed 42",
      "Make 2 medium 5x5 math cage puzzles with addition and subtraction only, 2 per page, seed 300"
    ],
    "brandColor": "#B4532A",
    "brandColorDark": "#F0A07A",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/math-cages/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Addition-only set for a class",
              "prompt": "Make 4 easy 4x4 math cage puzzles with addition only for my class, 2 per page, titled Number Fun, seed 11",
              "tools_triggered": "generate_math_cages",
              "expected_behavior": "Calls generate_math_cages once with count 4, size 4, operations addition only, difficulty easy, per_page 2. The reply says each 4 x 4 puzzle has one solution, seeds 11 to 14, and gives a PDF link with 4 Letter pages: 2 puzzle pages and 2 answer key pages."
            },
            {
              "description": "Hard 6x6 on A4",
              "prompt": "Make a hard 6x6 math cage puzzle with all four operations on A4, seed 42",
              "tools_triggered": "generate_math_cages",
              "expected_behavior": "Calls generate_math_cages once with size 6, difficulty hard, paper a4. The reply gives a 6 x 6 puzzle with 16 cages and 4 single-number cells, checked for one solution, and a 2 page A4 PDF with the answer key."
            },
            {
              "description": "Addition and subtraction practice",
              "prompt": "Make 2 medium 5x5 math cage puzzles with addition and subtraction only, 2 per page, seed 300",
              "tools_triggered": "generate_math_cages",
              "expected_behavior": "Calls generate_math_cages once with count 2, size 5, operations addition and subtraction. The reply lists 2 puzzles with 10 and 9 cages, seeds 300 and 301, and a 2 page PDF (1 puzzle page and 1 answer page)."
            },
            {
              "description": "Mixed sizes in one PDF",
              "prompt": "One easy 4x4 addition-only puzzle (seed 9), one medium 6x6 (seed 10) and one hard 9x9 (seed 11), all signs for the last two, 2 per page",
              "tools_triggered": "generate_math_cages",
              "expected_behavior": "Calls generate_math_cages once with 3 objects in puzzles. The reply lists the 3 puzzles; the 4 x 4 has 7 cages, the 6 x 6 has 15 cages and the 9 x 9 has 29 cages. The PDF has 4 pages: 2 puzzle pages and 2 answer pages."
            },
            {
              "description": "Big hard puzzle without answers",
              "prompt": "A hard 9x9 math cage puzzle with + - x and /, no answer key and no name line, seed 77",
              "tools_triggered": "generate_math_cages",
              "expected_behavior": "Calls generate_math_cages once with size 9, difficulty hard, answer_key false, name_line false. The reply says the puzzle has 30 cages and 3 single-number cells with one solution, and the PDF is 1 page."
            }
          ],
          "negative": [
            {
              "description": "Solving a puzzle from a photo is out of scope. Expected: the tool is not called; the assistant says this plugin makes new puzzles and does not read puzzle photos.",
              "prompt": "Here is a photo of the cage puzzle from today's newspaper, what goes in the top row?"
            },
            {
              "description": "A plain sudoku is a different puzzle. Expected: the tool is not called; the assistant explains this plugin makes math cage puzzles, not classic sudoku with given digits.",
              "prompt": "Make me a classic 9x9 sudoku with given numbers"
            },
            {
              "description": "Arithmetic help is not this job. Expected: the tool is not called; the assistant answers the math question without this plugin.",
              "prompt": "What is 144 divided by 12?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://math-cages.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Version 1.0.0: math cage puzzles from 4 x 4 to 9 x 9 with chosen operations, one solution checked by a solver, 1, 2 or 4 per page, Letter or A4, answer key pages.",
        "translations": {
          "pl-PL": {
            "subtitle": "\u0141amig\u0142\u00f3wki z klatkami",
            "description": "\u0141amig\u0142\u00f3wki matematyczne z klatkami do druku dla nauczycieli i uczni\u00f3w, jako PDF z kluczem odpowiedzi. Siatki od 4 x 4 do 9 x 9: w ka\u017cdym wierszu i kolumnie liczby od 1 do N po jednym razie, a ka\u017cda klatka daje sw\u00f3j wynik podanym dzia\u0142aniem. Wybierz dzia\u0142ania (tylko dodawanie, dodawanie i odejmowanie, wszystkie cztery) i poziom trudno\u015bci. Solver sprawdza, \u017ce ka\u017cda \u0142amig\u0142\u00f3wka ma jedno rozwi\u0105zanie. 1, 2 lub 4 na stronie, Letter lub A4, tytu\u0142 i linia na imi\u0119, na ko\u0144cu strony z odpowiedziami. Ten sam seed daje t\u0119 sam\u0105 \u0142amig\u0142\u00f3wk\u0119."
          },
          "de-DE": {
            "subtitle": "Rechenr\u00e4tsel mit K\u00e4figen",
            "description": "Rechenr\u00e4tsel mit K\u00e4figen zum Ausdrucken f\u00fcr Lehrkr\u00e4fte und Sch\u00fcler, als PDF mit L\u00f6sungsseiten. Gitter von 4 x 4 bis 9 x 9: jede Zeile und Spalte enth\u00e4lt die Zahlen 1 bis N einmal, und jeder K\u00e4fig ergibt mit seinem Rechenzeichen die Zielzahl. W\u00e4hle die Rechenarten (nur Plus, Plus und Minus, alle vier) und die Schwierigkeit. Ein L\u00f6ser pr\u00fcft, dass jedes R\u00e4tsel eine L\u00f6sung hat. 1, 2 oder 4 pro Seite, Letter oder A4, Titel und Namenszeile, am Ende die L\u00f6sungen. Derselbe Seed ergibt dasselbe R\u00e4tsel."
          },
          "es-ES": {
            "subtitle": "Acertijos de jaulas",
            "description": "Acertijos matem\u00e1ticos de jaulas para imprimir para docentes y estudiantes, en PDF con solucionario. Cuadr\u00edculas de 4 x 4 a 9 x 9: cada fila y columna lleva los n\u00fameros del 1 al N una vez, y cada jaula alcanza su resultado con su signo. Elige las operaciones (solo suma, suma y resta, las cuatro) y la dificultad. Un solucionador comprueba que cada acertijo tiene una sola soluci\u00f3n. 1, 2 o 4 por p\u00e1gina, Carta o A4, t\u00edtulo y l\u00ednea para el nombre, y al final las soluciones. La misma semilla da el mismo acertijo."
          },
          "fr-FR": {
            "subtitle": "Casse-t\u00eates \u00e0 cages",
            "description": "Casse-t\u00eates de calcul \u00e0 cages \u00e0 imprimer pour enseignants et \u00e9l\u00e8ves, en PDF avec corrig\u00e9. Grilles de 4 x 4 \u00e0 9 x 9 : chaque ligne et colonne contient les nombres de 1 \u00e0 N une fois, et chaque cage atteint son r\u00e9sultat avec son signe. Choisissez les op\u00e9rations (addition seule, addition et soustraction, les quatre) et la difficult\u00e9. Un solveur v\u00e9rifie que chaque grille a une seule solution. 1, 2 ou 4 par page, Letter ou A4, titre et ligne pour le nom, puis les pages de corrig\u00e9. La m\u00eame graine redonne la m\u00eame grille."
          },
          "ja-JP": {
            "subtitle": "\u5370\u5237\u7528\u306e\u8a08\u7b97\u30b1\u30fc\u30b8\u30d1\u30ba\u30eb",
            "description": "\u5148\u751f\u3068\u751f\u5f92\u306e\u305f\u3081\u306e\u5370\u5237\u7528\u8a08\u7b97\u30b1\u30fc\u30b8\u30d1\u30ba\u30eb\u3092\u3001\u7b54\u3048\u306e\u30da\u30fc\u30b8\u4ed8\u304dPDF\u3067\u4f5c\u308a\u307e\u3059\u30024 x 4\u304b\u30899 x 9\u306e\u30de\u30b9\u306b\u3001\u5404\u884c\u3068\u5404\u5217\u30781\u304b\u3089N\u306e\u6570\u30921\u56de\u305a\u3064\u5165\u308c\u3001\u592a\u7dda\u3067\u56f2\u3093\u3060\u30b1\u30fc\u30b8\u306f\u8a18\u53f7\u306e\u8a08\u7b97\u3067\u76ee\u6a19\u306e\u6570\u306b\u306a\u308a\u307e\u3059\u3002\u8db3\u3057\u7b97\u3060\u3051\u3001\u8db3\u3057\u7b97\u3068\u5f15\u304d\u7b97\u3001\u56db\u5247\u3059\u3079\u3066\u306a\u3069\u306e\u8a08\u7b97\u3068\u3001\u96e3\u3057\u3055\u3092\u9078\u3079\u307e\u3059\u3002\u30bd\u30eb\u30d0\u30fc\u3067\u5404\u554f\u984c\u306e\u7b54\u3048\u304c1\u3064\u3060\u3051\u3067\u3042\u308b\u3053\u3068\u3092\u78ba\u8a8d\u3057\u307e\u3059\u30021\u30da\u30fc\u30b8\u306b1\u30012\u30014\u554f\u3001\u30ec\u30bf\u30fc\u307e\u305f\u306fA4\u3001\u30bf\u30a4\u30c8\u30eb\u3068\u540d\u524d\u6b04\u4ed8\u304d\u3002\u540c\u3058\u30b7\u30fc\u30c9\u3067\u540c\u3058\u554f\u984c\u3092\u3082\u3046\u4e00\u5ea6\u4f5c\u308c\u307e\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Quebra-cabe\u00e7as de gaiolas",
            "description": "Quebra-cabe\u00e7as matem\u00e1ticos de gaiolas para imprimir para professores e alunos, em PDF com gabarito. Grades de 4 x 4 a 9 x 9: cada linha e coluna tem os n\u00fameros de 1 a N uma vez, e cada gaiola chega ao seu resultado com o seu sinal. Escolha as opera\u00e7\u00f5es (s\u00f3 adi\u00e7\u00e3o, adi\u00e7\u00e3o e subtra\u00e7\u00e3o, as quatro) e a dificuldade. Um solucionador confere que cada quebra-cabe\u00e7a tem uma s\u00f3 solu\u00e7\u00e3o. 1, 2 ou 4 por p\u00e1gina, Carta ou A4, t\u00edtulo e linha para o nome, e no final o gabarito. A mesma semente gera o mesmo quebra-cabe\u00e7a."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}