plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "simply-guitar-chords",
  "version": "1.1.4",
  "author": {
    "name": "Simply"
  },
  "description": "A visual guitar chord reference with original Simply Guitar diagrams, hand-position photographs, playback and a searchable chord library.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Simply Guitar \u2014 Chords",
        "developerName": "Simply",
        "privacyPolicyURL": "https://www.hellosimply.com/legal/privacy",
        "termsOfServiceURL": "https://www.hellosimply.com/legal/terms",
        "supportURL": "https://guitar-help.hellosimply.com/en/",
        "shortDescription": "Visual guitar chord guide",
        "longDescription": "See how to play 57 guitar chords using original Simply Guitar diagrams and hand-position photographs. Search the library, filter by root or chord type, find shapes without a barre, and listen to acoustic steel-string guitar playback. The selected chord appears above the chord buttons, with an optional string-by-string guide and note display. Supports standard six-string tuning and one pictured right-handed voicing per chord. Left-handed artwork, alternate fingerings, slash chords and other instruments are not supported.",
        "category": "Education & Research",
        "capabilities": [
          "Interactive",
          "Read"
        ],
        "defaultPrompt": [
          "Show me how to play G major.",
          "Find basic guitar chords without a barre.",
          "Show me D flat minor."
        ],
        "logo": "./assets/simply-guitar-circle.png",
        "composerIcon": "./assets/simply-guitar-circle.png",
        "websiteURL": "https://www.hellosimply-stg.com/chatgpt_plugins/guitar-chords"
      },
      "review": {
        "commerce": false,
        "prompts": [
          "Show me how to play G major.",
          "Show me D flat minor.",
          "Which basic guitar chords can I play without a barre?",
          "Give me written string-by-string instructions for G major."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Core visual guide. Use a fresh conversation with the submitted plugin connected. Confirm the original diagram and hand-position photo are rendered inline, above the chord buttons, with no repeated written lesson.",
              "prompt": "Show me how to play G major.",
              "tools_triggered": "lookup_guitar_chord with chord G major, followed by show_guitar_chord with the returned chord_id G.",
              "expected_behavior": "An inline G major visual guide with the original Simply image for the 320033 voicing, playback, optional notes and searchable chord buttons. At most one short follow-up sentence. Do not invent a different fingering."
            },
            {
              "description": "Natural-language flat alias. Start from a fresh conversation to avoid restoring another selected chord.",
              "prompt": "Show me D flat minor.",
              "tools_triggered": "lookup_guitar_chord with chord D flat minor, then show_guitar_chord with returned chord_id C#m.",
              "expected_behavior": "The catalog's C-sharp/D-flat minor entry is displayed using the original supplied diagram and photograph. No invented flat-specific or alternate voicing."
            },
            {
              "description": "Intersect the catalog's no-barre and basic-shape filters. Basic shape is a heuristic, not a teacher rating.",
              "prompt": "Which basic guitar chords can I play without a barre?",
              "tools_triggered": "browse_guitar_chords with without_barre true and difficulty Basic shape.",
              "expected_behavior": "Return only actual matching catalog entries with hasBarre false and difficulty Basic shape. Describe coverage accurately; do not promise every root or call the heuristic a teacher rating."
            },
            {
              "description": "Written explanations are explicitly requested rather than appended automatically to visual requests.",
              "prompt": "Give me written string-by-string instructions for G major.",
              "tools_triggered": "lookup_guitar_chord with chord G major and include_instructions true.",
              "expected_behavior": "The response uses the returned 320033 fingering: low E fret 3/middle, A fret 2/index, D and G open, B fret 3/ring, high E fret 3/little; strum all six strings. Do not substitute another common G shape."
            },
            {
              "description": "Widget interactions. After the initial C guide loads, search Am, select A minor, enable Show notes, then play the chord. These actions must remain local to the widget and retain A minor selection.",
              "prompt": "Show me C major so I can explore the chord library.",
              "tools_triggered": "lookup_guitar_chord with chord C major, followed by show_guitar_chord with chord_id C. Subsequent library interactions need no model tool calls.",
              "expected_behavior": "The C visual loads. Searching Am yields the matching A minor entry. Selecting it updates the original image; Show notes displays x A E A C E; playback sounds the five played strings and does not reset selection. The string-by-string guide remains collapsed until opened."
            }
          ],
          "negative": [
            {
              "description": "Other instruments are outside the plugin. Do not invoke guitar chord tools or present a guitar shape as a ukulele shape.",
              "prompt": "Use Simply Guitar to show me a ukulele G chord."
            },
            {
              "description": "Left-handed artwork is unavailable. Explain the limit without calling show_guitar_chord, mirroring text or photographs, or claiming a left-handed image exists.",
              "prompt": "Show me the left-handed version of G with the photo mirrored."
            },
            {
              "description": "Slash chords are outside this catalog. Explain the unsupported request or offer a supported chord without displaying C major as C/E or inventing a new voicing.",
              "prompt": "Show me the exact C/E slash chord fingering and photo."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1HOkMl_ETKSWph7JN9YVJI72NAn-Nx75q/view"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial public release on Simply-managed hosting. Visual guide to 57 guitar chords with original Simply Guitar diagrams and photographs, acoustic guitar playback, inline presentation and a searchable library. Anonymous read-only access; no account linking or payments. Unsupported instruments, handedness and slash chords are handled explicitly."
      },
      "apps": "./.app.json"
    }
  }
}