plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "puzzel-org",
  "version": "1.0.3",
  "description": "Create crosswords, word searches, quizzes and other interactive learning activities with Puzzel.org.",
  "author": {
    "name": "Puzzel.org",
    "email": "daan@puzzel.org",
    "url": "https://puzzel.org"
  },
  "homepage": "https://puzzel.org/en/features/ai-assistant-connector",
  "keywords": [
    "education",
    "puzzles",
    "quizzes",
    "classroom",
    "learning activities"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Puzzel.org",
        "shortDescription": "Interactive puzzle maker",
        "longDescription": "Create and manage interactive crosswords, word searches, quizzes, puzzles, games, and classroom exercises in your Puzzel.org account. Generate content in many languages, edit or copy existing activities, and open classroom PINs. The plugin returns play and edit links; it does not read student responses or results.",
        "developerName": "Puzzel.org",
        "category": "Education & Research",
        "capabilities": [
          "Create activities",
          "Manage activities",
          "Classroom PINs"
        ],
        "websiteURL": "https://puzzel.org/en/features/ai-assistant-connector",
        "supportURL": "https://puzzel.org/en/help",
        "privacyPolicyURL": "https://puzzel.org/en/privacy-policy#assistants",
        "termsOfServiceURL": "https://puzzel.org/en/terms-conditions",
        "defaultPrompt": [
          "Create a forest-themed crossword for students aged 10 to 12.",
          "Turn these terms and definitions into a match-up activity.",
          "Show my recent Puzzel.org activities."
        ],
        "composerIcon": "./assets/puzzel-icon.png",
        "logo": "./assets/puzzel-icon.png"
      },
      "onboardingSkill": "./skills/puzzel-activities/SKILL.md",
      "review": {
        "demo_recording_url": "https://puzzelorg-cdn.s3.us-west-1.amazonaws.com/static/videos/puzzel-plugin-demo-trimmed.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Create a complete hosted crossword and return owner and participant links.",
              "prompt": "Create an English crossword for 10-year-olds with eight clues about the water cycle.",
              "tools_triggered": "get_activity_type, create_activity",
              "expected_behavior": "Inspect the crossword content schema, create an age-appropriate eight-clue crossword in the connected test account, and return both its play URL and edit URL."
            },
            {
              "description": "Find activities in the connected account without modifying them.",
              "prompt": "Show my three most recent Puzzel.org activities.",
              "tools_triggered": "list_activities",
              "expected_behavior": "Return at most three activities from the connected test account in newest-first order, including their titles, types, and available play and edit links."
            },
            {
              "description": "Safely update a known fixture after reading its complete current content. The reviewer account must contain an editable quiz named Reviewer Solar System Quiz.",
              "prompt": "Add a multiple-choice question about Saturn's rings to my activity named Reviewer Solar System Quiz, keeping every existing question.",
              "tools_triggered": "list_activities, get_activity, update_activity",
              "expected_behavior": "Find the named quiz, read its full content, append one accurate multiple-choice question about Saturn's rings, preserve all existing questions and settings, and return the updated activity links."
            },
            {
              "description": "Copy a known fixture so the original remains unchanged. The reviewer account must contain an activity named Reviewer Solar System Quiz.",
              "prompt": "Make a copy of Reviewer Solar System Quiz called Reviewer Solar System Quiz - Class B.",
              "tools_triggered": "list_activities, copy_activity",
              "expected_behavior": "Find the named source activity, create a separate copy with the requested title, leave the original unchanged, and return links for the new copy."
            },
            {
              "description": "Open a short-lived classroom PIN for a known fixture. The reviewer account must contain an activity named Reviewer Solar System Quiz.",
              "prompt": "Open a classroom PIN for Reviewer Solar System Quiz for one lesson.",
              "tools_triggered": "list_activities, open_join_pin",
              "expected_behavior": "Find the named activity, open a lesson-duration PIN, and return both the six-digit PIN and the join URL."
            }
          ],
          "negative": [
            {
              "description": "Student results are outside this plugin's capabilities: explain that limitation. No Puzzel tool returns student answers or scores, so the reply contains no result data.",
              "prompt": "Show me every student's answers and scores from yesterday's quiz."
            },
            {
              "description": "Activity deletion is unsupported; do not call another mutating tool as a substitute.",
              "prompt": "Delete all activities in my Puzzel.org account."
            },
            {
              "description": "Purchasing and subscription management are unsupported; direct the user to the Puzzel.org website without attempting a tool call.",
              "prompt": "Buy a paid Puzzel.org plan for my school with my saved payment method."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin has no paid features and does not offer purchases or process payments. Users can separately upgrade to Premium on the Puzzel.org website."
      },
      "publication": {
        "countries": [],
        "release_notes": "Five more activity types: A to Z quiz, Guess Who, map quiz, spelling test and advent calendar. They were held out of the tool list while version 1.0.2 was in review, so the listing did not change mid-review. create_activity and get_activity_type now name 43 types instead of 38; no tool was added, removed or renamed, and every tool keeps its annotations. The onboarding skill lists the new types and points to create_activity's type parameter as the complete list. The descriptions now name crosswords and word searches, and the subtitle reads \"Interactive puzzle maker\"."
      },
      "apps": "./.app.json"
    }
  }
}