plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "clef",
  "version": "1.0.1",
  "description": "Read-only music utilities for finding Clef guides, transposing chord symbols, spelling piano chords, and mapping six-string ASCII guitar tab to piano pitches.",
  "author": {
    "name": "Clef",
    "url": "https://clefdrills.com"
  },
  "homepage": "https://clefdrills.com",
  "keywords": [
    "music",
    "piano",
    "chords",
    "guitar-tab"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Clef",
        "shortDescription": "Chords, piano notes & guides",
        "longDescription": "Use four public, read-only Clef tools to find instructional music guides, transpose chord symbols (including slash chords), spell supported chords as piano pitches with MIDI values, and map standard six-string ASCII guitar tab to sounding piano pitches. Clef does not accept audio or notation-file uploads, parse Guitar Pro files, infer rhythm or note duration from tab spacing, or create rhythmic arrangements.",
        "developerName": "Clef",
        "category": "Productivity",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://clefdrills.com/",
        "supportURL": "https://clefdrills.com/support/",
        "privacyPolicyURL": "https://clefdrills.com/privacy/",
        "termsOfServiceURL": "https://clefdrills.com/terms/",
        "defaultPrompt": [
          "Transpose C Am F G/B up two semitones.",
          "Spell Cmaj7 as piano notes in octave 4.",
          "Find a Clef guide to repairing MIDI notation."
        ],
        "brandColor": "#111827",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a relevant instructional guide",
              "prompt": "Find a Clef guide about repairing MIDI notation.",
              "tools_triggered": "find_music_guides",
              "expected_behavior": "Return matching Clef guide titles, descriptions, and URLs, including the MIDI notation repair guide when relevant; do not claim to convert a file."
            },
            {
              "description": "Transpose a progression with a slash chord",
              "prompt": "Transpose C Am F G/B up two semitones and prefer sharps.",
              "tools_triggered": "transpose_chords",
              "expected_behavior": "Return D Bm G A/C# and the Clef browser-tool URL."
            },
            {
              "description": "Spell a supported seventh chord",
              "prompt": "Spell Cmaj7 as piano pitches in octave 4.",
              "tools_triggered": "spell_piano_chord",
              "expected_behavior": "Return C4, E4, G4, and B4 with MIDI values 60, 64, 67, and 71."
            },
            {
              "description": "Map standard ASCII guitar tab to pitches",
              "prompt": "Map this standard six-string ASCII guitar tab to piano pitches:\ne|--0--|\nB|--1--|\nG|--0--|\nD|--2--|\nA|--3--|\nE|-----|",
              "tools_triggered": "tab_to_piano_notes",
              "expected_behavior": "Return the sounding pitches for the tab event and warn that columns show order rather than rhythm and no durations are inferred."
            },
            {
              "description": "Read a published Clef guide resource",
              "prompt": "Read the Clef resource at https://clefdrills.com/blog/midi-notation-rhythm-repair.html and summarize its practical repair steps.",
              "tools_triggered": "resources/read",
              "expected_behavior": "Read the matching published resource and summarize its guidance without claiming access to or analysis of a user's MIDI file."
            }
          ],
          "negative": [
            {
              "description": "Reject an out-of-range transposition",
              "prompt": "Transpose C up 25 semitones.",
              "expected_behavior": "The request is outside the supported range: transpose_chords accepts -24 to +24 semitones, so +25 must be refused by the tool rather than silently accepted."
            },
            {
              "description": "Reject an unsupported chord symbol",
              "prompt": "Spell H13 as piano notes.",
              "expected_behavior": "H13 is not a supported chord symbol, so the plugin must return an invalid-chord error instead of guessing pitches."
            },
            {
              "description": "Do not claim unsupported file or audio processing",
              "prompt": "Listen to my recording, infer its rhythm, and convert the attached Guitar Pro file into sheet music.",
              "expected_behavior": "Clef does not accept audio or notation-file uploads, parse Guitar Pro files, or infer rhythm, so the plugin must explain the limitation instead of claiming to perform the conversion."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin provides free read-only music utilities and does not sell products or process payments.",
        "demo_recording_url": "https://clefdrills.com/demos/clef-chatgpt-walkthrough.mp4"
      },
      "publication": {
        "release_notes": "Adds category, reviewer walkthrough video URL, and negative-case explanations. Four public read-only Clef music tools and published guide resources."
      },
      "apps": "./.app.json"
    }
  }
}