plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "graphchinese",
  "version": "1.2.2",
  "description": "Learn Mandarin by conversation: questions that start and keep conversations going, plus a dictionary, grammar and learn-first reference with HSK levels.",
  "author": {
    "name": "Carson Mulligan",
    "email": "hi@verticalchinese.com",
    "url": "https://graphchinese.com"
  },
  "homepage": "https://graphchinese.com",
  "keywords": [
    "chinese",
    "mandarin",
    "hsk",
    "dictionary",
    "grammar",
    "pinyin"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GraphChinese",
        "shortDescription": "Learn Chinese by conversation",
        "longDescription": "Learn Mandarin by talking, not memorising. The plugin coaches you to ask questions that start conversations and keep them going, teaching you the words you need as they come up, with how characters are built, how the grammar works and a little culture along the way. Ask what to learn first and get real answers: the most common characters and how much of real text they cover, the opening words and grammar of each HSK level in teaching order, and core words by topic. Also look up any word, split a sentence into words with pinyin and level, and search 195 grammar points from HSK 1 to 6 with examples and what to learn before each.",
        "developerName": "Carson Mulligan",
        "category": "Education & Research",
        "websiteURL": "https://graphchinese.com/",
        "supportURL": "https://graphchinese.com/contact",
        "privacyPolicyURL": "https://graphchinese.com/privacy-policy",
        "termsOfServiceURL": "https://graphchinese.com/terms",
        "defaultPrompt": [
          "What are the most useful Chinese characters to learn first?",
          "What words should I learn first for HSK 3?",
          "I'm studying for HSK 3. Teach me questions that keep a conversation going."
        ],
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Look up one Chinese word",
              "prompt": "What does \u4fbf\u5b9c mean?",
              "tools_triggered": "lookup_word",
              "expected_behavior": "Calls lookup_word with word \u4fbf\u5b9c. Gives the pinyin pi\u00e1n yi and the meaning cheap or inexpensive, says it is HSK 2, may mention the other reading bi\u00e0n y\u00ed, and links to the \u4fbf\u5b9c dictionary page on graphchinese.com."
            },
            {
              "description": "Pareto: which characters matter most",
              "prompt": "Which Chinese characters should I learn first to read the most text?",
              "tools_triggered": "get_common_characters",
              "expected_behavior": "Calls get_common_characters. Lists the most frequent characters starting with \u7684, \u662f, \u6211, with pinyin and meaning, and says how many characters cover 50, 80, 90 and 95 percent of the text counted."
            },
            {
              "description": "What to learn first at a level",
              "prompt": "What words should I learn first for HSK 3?",
              "tools_triggered": "get_study_order",
              "expected_behavior": "Calls get_study_order with level 3. Lists the opening vocabulary lessons of HSK 3 in order, each a themed group of words with pinyin and meaning."
            },
            {
              "description": "Explain a grammar point and its prerequisites",
              "prompt": "Explain the Chinese grammar pattern \u6b63\u5728\u2026\u5462 and what I should learn first.",
              "tools_triggered": "search_grammar, get_grammar_point",
              "expected_behavior": "Calls search_grammar with \u6b63\u5728, then get_grammar_point with slug progressive-action. Explains that \u6b63\u5728 + verb (+ \u5462) marks an action happening right now, shows worked examples with pinyin and English, and names Progressive Aspect as the point to learn first."
            },
            {
              "description": "Conversation coaching at a level",
              "prompt": "I'm studying for HSK 3. Have a conversation with me and teach me how to ask questions that keep it going.",
              "tools_triggered": "get_study_order, segment_text, lookup_word",
              "expected_behavior": "Follows the conversation-coach skill: asks the learner's interests, speaks short Chinese with pinyin inside HSK 3, asks one question per turn, teaches a chase question such as \u540e\u6765\u5462 or \u4e3a\u4ec0\u4e48, and looks up new words with lookup_word."
            }
          ],
          "negative": [
            {
              "description": "No commerce: the plugin cannot sell or sign anyone up",
              "prompt": "How much does GraphChinese cost? Sign me up for it.",
              "expected_behavior": "No tool is called for pricing or signup, because none exists. The plugin returns no price and no checkout or registration link."
            },
            {
              "description": "No account data: the plugin has no access to user accounts",
              "prompt": "Show me my GraphChinese progress and what is due for review today.",
              "expected_behavior": "No tool takes an identity or returns user data. ChatGPT says the plugin cannot see accounts or progress."
            },
            {
              "description": "Out of scope: languages other than Chinese",
              "prompt": "Use GraphChinese to look up the Japanese word \u3042\u308a\u304c\u3068\u3046.",
              "expected_behavior": "If lookup_word is called it returns an error saying there is no dictionary entry. ChatGPT does not present a GraphChinese result for a Japanese word."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/CQBHg4sLO0w",
        "commerce": false,
        "commerce_description": "This plugin does not sell products, take payments or link to checkout."
      },
      "publication": {
        "release_notes": "Adds two skills: a conversation coach that teaches by asking questions, and a learn-first guide for what to study first."
      },
      "apps": "./.app.json"
    }
  }
}