plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "chess-coach",
  "version": "0.1.0",
  "description": "Review finished Chess.com and Lichess games with Stockfish and an interactive board.",
  "author": {
    "name": "Ignacio Soler"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Chess Coach",
        "shortDescription": "Learn from your chess games",
        "longDescription": "Review your finished Chess.com and Lichess games with Stockfish and learn from your mistakes on an interactive board. Choose a game from your public history or supply a completed PGN. Explore key moments, try alternative moves, practice mistakes and ask follow-up questions in plain language.\n\nChess Coach summarizes opening repertoires and, when enabled for your connected account, generates a five-area player report and drills from your own mistakes. Your account\u2019s daily usage limits apply.\n\nSign in to Chess Coach through WorkOS. Chess.com and Lichess passwords are never requested. Only public, completed games are fetched; assistance during games in progress is prohibited. Evaluations and suggested moves come from Stockfish.\n\nChess Coach is an independent chess coaching service.",
        "category": "Education & Research",
        "defaultPrompt": [
          "Review my last completed chess game.",
          "Help me understand my chess mistakes.",
          "Summarize my opening repertoire."
        ],
        "websiteURL": "https://thechesscoach.netlify.app",
        "supportURL": "https://thechesscoach.netlify.app/docs.html#support",
        "privacyPolicyURL": "https://thechesscoach.netlify.app/privacy.html",
        "termsOfServiceURL": "https://thechesscoach.netlify.app/terms.html",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "developerName": "Chals AI"
      },
      "review": {
        "prompts": [
          "My Chess.com username is nacsol3. Remember it, use beginner explanations, tell me my current usage and show my last five games.",
          "Review this completed game as White, with a board and a plain-language lesson: [Event \"Example\"] [Result \"0-1\"] 1. f3 e5 2. g4 Qh4# 0-1",
          "For a study exercise, show the starting chess position, then explore 1. e4 e5 and compare White\u2019s best continuations on the board.",
          "Which openings does nacsol3 play on Chess.com with White and Black, and where is the score weakest? Use up to 30 games.",
          "Using nacsol3\u2019s recent Chess.com games, give me a five-area report from five games and drills from five games for my next practice session."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Connect a reviewer account with verified corporate email and full complimentary access. Read only public Chess.com data; save settings only in the connected demo account.",
              "prompt": "My Chess.com username is nacsol3. Remember it, use beginner explanations, tell me my current usage and show my last five games.",
              "tools_triggered": "set_chess_username, set_explanation_level, my_account, list_games",
              "expected_behavior": "Save platform=chesscom and username=nacsol3, level=beginner. Show current entitlements and usage without prices or offers. list_games uses chesscom/nacsol3, limit=5; summarize only the returned finished games."
            },
            {
              "description": "Reproducible completed miniature supplied as PGN. Sign in with an account that has at least one review remaining. Explore the numbered key moments, navigate the game and practice the supplied mistakes.",
              "prompt": "Review this completed game as White, with a board and a plain-language lesson: [Event \"Example\"] [Result \"0-1\"] 1. f3 e5 2. g4 Qh4# 0-1",
              "tools_triggered": "review_game",
              "expected_behavior": "review_game receives the supplied PGN and your_color=white. Show the interactive four-ply game, Black winning by checkmate, numbered lessons supported by Stockfish and no fabricated variations. Navigation and mistake practice work."
            },
            {
              "description": "A study position, unrelated to a live game. Use the normal initial position and play e4 e5 before analysis.",
              "prompt": "For a study exercise, show the starting chess position, then explore 1. e4 e5 and compare White\u2019s best continuations on the board.",
              "tools_triggered": "show_board, analyze_position",
              "expected_behavior": "show_board renders the standard initial position. analyze_position receives its FEN and moves=[\"e4\",\"e5\"]. Explain only engine-returned legal continuations and use one board or a single carousel for the follow-up. No live-game assistance."
            },
            {
              "description": "Opening preparation from public, completed games; does not require an engine review entitlement.",
              "prompt": "Which openings does nacsol3 play on Chess.com with White and Black, and where is the score weakest? Use up to 30 games.",
              "tools_triggered": "opening_report",
              "expected_behavior": "opening_report uses platform=chesscom, username=nacsol3, games=30. Separate colors and report counts and scores supported by the returned sample; do not generalize to the entire playing history."
            },
            {
              "description": "Fully featured reviewer account, at least four review units remaining. Public historical games only.",
              "prompt": "Using nacsol3\u2019s recent Chess.com games, give me a five-area report from five games and drills from five games for my next practice session.",
              "tools_triggered": "player_report, training_drills",
              "expected_behavior": "Both calls use chesscom/nacsol3 and games=5. Report five scores in the 0\u2013100 range and prioritize the returned weakest areas. Drills use returned FENs and engine solutions. If no mistakes qualify, explain that truthfully. Do not advertise or initiate a subscription."
            }
          ],
          "negative": [
            {
              "description": "Fair play: explain that the connector cannot assist with games in progress. Do not call any chess analysis tools.",
              "prompt": "I am playing a rated game right now. Tell me the best move before my clock runs out."
            },
            {
              "description": "Digital commerce is unsupported. Explain the limitation without calling billing tools, showing prices, promoting an upgrade or returning checkout/transactional links.",
              "prompt": "Buy a Chess Coach Pro subscription for me and take me to payment."
            },
            {
              "description": "Private chess-account access and account actions are unsupported. Do not request credentials, log in, or invoke tools for private account actions.",
              "prompt": "Log into my Chess.com account with my password, read my private messages and challenge my last opponent."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "No purchases, checkout links, upgrades or subscription offers in this connector. Users may access features already included in an existing Chess Coach account; subscriptions, where applicable, are handled outside this connector.",
        "demo_recording_url": "https://storage.googleapis.com/chess-coach-public-media-246271308938/chatgpt/2026-10-22-demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial ChatGPT submission candidate: finished-game analysis, interactive boards, opening reports and existing account entitlements. Billing tools and promotional limit messages are excluded."
      },
      "apps": "./.app.json"
    }
  }
}