plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "study-hiragana",
  "version": "1.0.4",
  "description": "Learn to write Japanese hiragana, katakana and kanji on an interactive stroke-order canvas.",
  "author": {
    "name": "Study Hiragana",
    "email": "contact@studyhiragana.com",
    "url": "https://studyhiragana.com"
  },
  "homepage": "https://studyhiragana.com",
  "keywords": [
    "japanese",
    "hiragana",
    "katakana",
    "kanji",
    "handwriting",
    "stroke order",
    "language learning"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Study Hiragana",
        "shortDescription": "Learn to write kana & kanji",
        "longDescription": "Study Hiragana helps you learn to write Japanese by hand. Ask to practise a character and an interactive writing canvas opens in the conversation, where you draw with your finger, a stylus or a mouse.\n\n- Trace: follow the character's outline with stroke-order guides.\n- Free Hand: write it from memory on a blank canvas. Your writing is checked for shape, stroke order and stroke direction, with a tip when a stroke is out of order or drawn backwards. The character stays hidden until you finish.\n\nEvery hiragana and katakana character is covered, including dakuten and combinations such as \u304d\u3083, plus about 300 kanji (mostly JLPT N5 and N4, with more added over time). The canvas opens on the character you asked for; for kana you can then tap any other character in its row, pick another row, or switch between hiragana and katakana without asking again. Kanji open one at a time, on request. Under the canvas you see an example word and a pronunciation tip for kana, or on/kun readings and example words for kanji. You can also ask for a stroke-by-stroke explanation of a character in text, or for a list of the characters available.\n\nThe stroke-order data was traced by hand by Study Hiragana. Your drawing is checked on your own device and is not sent anywhere. No account is needed.\n\nLimitations: kanji without stroke data (most kanji beyond JLPT N4) cannot be practised on the canvas yet. Free Hand for kanji checks each stroke in order as you draw rather than the finished shape. The canvas cannot read photos of handwriting.",
        "developerName": "Study Hiragana",
        "category": "Education & Research",
        "capabilities": [
          "Practise writing hiragana and katakana",
          "Practise writing kanji",
          "Explain stroke order",
          "List available characters"
        ],
        "websiteURL": "https://studyhiragana.com",
        "supportURL": "https://studyhiragana.com/about#contact",
        "privacyPolicyURL": "https://studyhiragana.com/privacy",
        "termsOfServiceURL": "https://studyhiragana.com/terms",
        "defaultPrompt": [
          "Show me how to write \u3042",
          "I want to practise writing the kanji for water."
        ],
        "brandColor": "#20507E",
        "brandColorDark": "#6EA7D8",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Hiragana \u2014 trace with stroke-order guides",
              "prompt": "Show me how to write \u3042",
              "tools_triggered": "practice_writing",
              "expected_behavior": "A writing canvas opens for \u3042 (a, 3 strokes) in Trace mode, showing the outline with stroke-order guides, \"A\" and \"3 strokes\" in the canvas corners, the example word \u3042\u3055 (asa) \u2014 morning and a pronunciation tip. Under the canvas, the Vowels row (\u3042 \u3044 \u3046 \u3048 \u304a) appears as buttons next to a Play button. Tracing the three strokes in order shows \"Traced \u2713\". Tapping \u3044 loads \u3044 on the canvas; the Hiragana/Katakana toggle and the row picker above the canvas switch script or row."
            },
            {
              "description": "Hiragana \u2014 write from memory with Free Hand",
              "prompt": "Show me how to write \u304d",
              "tools_triggered": "practice_writing",
              "expected_behavior": "A writing canvas opens for \u304d (ki, 4 strokes) in the K row. Selecting Free Hand hides the outline; the row buttons switch from characters to romaji (ka ki ku ke ko) and \u304d is masked in the example word (\uff3f\u3082\u306e (kimono)), while the canvas corner still shows \"KI\" as the prompt. Hint shows where the next stroke starts and stays until it is drawn. Writing \u304d reveals it and shows \"Written free hand \u2713\"; strokes in the wrong order still pass but show a stroke-order tip."
            },
            {
              "description": "Katakana \u2014 trace with stroke-order guides",
              "prompt": "Show me how to write \u30ab",
              "tools_triggered": "practice_writing",
              "expected_behavior": "A writing canvas opens for \u30ab (ka, 2 strokes) in Trace mode with Katakana selected in the toggle and the K row (\u30ab \u30ad \u30af \u30b1 \u30b3) under the canvas, the example word \u30ab\u30e1\u30e9 (kamera) \u2014 camera and a pronunciation tip. Tracing the two strokes in order shows \"Traced \u2713\"."
            },
            {
              "description": "Katakana \u2014 watch the stroke-order animation",
              "prompt": "Show me how to write \u30b7",
              "tools_triggered": "practice_writing",
              "expected_behavior": "A writing canvas opens for \u30b7 (shi, 3 strokes) with the example word \u30b7\u30e3\u30c4 (shatsu) \u2014 shirt. Pressing Play draws the three strokes one after another in the correct order and direction; the canvas is then ready to trace."
            },
            {
              "description": "Kanji \u2014 found by its English meaning",
              "prompt": "I want to practise writing the kanji for water.",
              "tools_triggered": "practice_writing",
              "expected_behavior": "A writing canvas opens for \u6c34 (water, 4 strokes) in Trace mode, on its own: kanji have no script toggle, row picker or character buttons. The readings On \u30b9\u30a4 / Kun \u307f\u305a and the example words \u6c34\u66dc\u65e5, \u6c34 and \u6c34\u6cf3 appear under the canvas. Tracing the four strokes in order shows \"Traced \u2713\"."
            }
          ],
          "negative": [
            {
              "description": "Not a writing-practice request: a plain translation question should be answered directly, without calling any Study Hiragana tools.",
              "prompt": "Translate \"good morning\" into Japanese."
            },
            {
              "description": "Unsupported script: Study Hiragana only covers Japanese kana and kanji, so no canvas should open. The assistant should explain that Korean is not supported (practice_writing returns a \"No stroke data\" error if called).",
              "prompt": "Help me practise writing the Korean letter \ud55c."
            },
            {
              "description": "Grading photos is not supported: the plugin cannot read images of handwriting and should not be used to grade one. The assistant may instead offer to open a writing canvas for the character.",
              "prompt": "Here's a photo of my handwriting \u2014 can you grade it?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell anything or process payments."
      },
      "publication": {
        "release_notes": "Initial release: interactive Trace and Free Hand writing canvas for all hiragana and katakana (browse rows and switch script inside the canvas) and about 300 kanji on request (more added over time), stroke-by-stroke explanations, readings and example words."
      },
      "apps": "./.app.json"
    }
  }
}