.codex-plugin/plugin.json

{
  "name": "chord-charts",
  "version": "1.0.0",
  "description": "Printable chord diagram sheets for guitar, ukulele and piano, with every shape checked note by note.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://chord-charts.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "guitar chord chart",
    "ukulele chord chart",
    "piano chord chart",
    "chord diagrams",
    "printable",
    "left handed",
    "capo",
    "transpose"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Chord Chart Maker",
    "shortDescription": "Printable chord diagrams",
    "longDescription": "Make a guitar chord chart printable in seconds: send a list of chords or paste a song with chords, and Zovo Chord Chart Maker draws a print-ready PDF of chord diagrams for guitar in standard tuning, ukulele in G C E A, or piano keyboards.\n\nEach guitar and ukulele shape is checked before it is printed. The tool computes the note on each string and keeps a shape only when each note belongs to the chord and the root is present. The note names are printed under the strings, so you can see why the shape is right. Piano diagrams are computed from the chord intervals and highlight the keys to press, with the bass note of a slash chord in a second colour.\n\nIt reads chord names the way charts write them (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E, A-7, C\u00f87) and can read the chords from a pasted chord sheet, with chords over lyrics or inline [Am] chords. You can transpose by semitones or to a new key, add a capo the way chord sheets write it (\"Capo 2\" with the shape names) and see which chord sounds, or give the chords that should sound and see the shapes to play with the capo, ask for the capo position with the easiest open shapes, mirror the diagrams for left-handed players, and choose 6, 12 or 24 diagrams per page on US Letter or A4. Barres are shown, finger numbers are printed when the source data has them, and positions higher up the neck are available for each chord.\n\nGood for a ukulele chord chart for a class, chord diagrams for a song before a jam, a beginner chord sheet, or a left-handed guitar chord chart.\n\nLimitations: guitar in standard tuning, ukulele in G C E A and piano only. No alternate tunings, bass, mandolin or banjo. Chord types outside the supported set are listed and skipped, not guessed, and some extended chords have no ukulele shape with the root. It does not write tabs, notation, strumming patterns or audio.",
    "developerName": "Zovo",
    "category": "Creativity",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://chord-charts.zovo.one",
    "supportURL": "https://chord-charts.zovo.one/support",
    "privacyPolicyURL": "https://chord-charts.zovo.one/privacy",
    "termsOfServiceURL": "https://chord-charts.zovo.one/terms",
    "defaultPrompt": [
      "Printable guitar chord chart for G, Em, C, D, Am7 and Dsus4",
      "Left-handed ukulele chord chart for C, G, Am and F, 6 per page on A4",
      "Piano chord chart for Cmaj7, Dm7, G7 and Fmaj7/A"
    ],
    "brandColor": "#2457B8",
    "brandColorDark": "#86A9F0",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/chord-charts/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Guitar chord chart for a list of chords",
              "prompt": "Printable guitar chord chart for G, Em, C, D, Am7 and Dsus4",
              "tools_triggered": "generate_chord_chart",
              "expected_behavior": "Calls generate_chord_chart with chords [G, Em, C, D, Am7, Dsus4]. Returns 6 guitar diagrams on 1 page with a PDF link. G is 320003 (G B D G B G), C is x32010 (C E G C E), Am7 is x02010 (A E G C E), Dsus4 is xx0233 (D A D G)."
            },
            {
              "description": "How to play one chord on ukulele",
              "prompt": "How do I play F#m7 on ukulele? Show me a few positions",
              "tools_triggered": "find_chord_fingerings",
              "expected_behavior": "Calls find_chord_fingerings with chords [F#m7] and instrument ukulele. Returns 3 positions lowest first, starting with 2424 (A E F# C#), each checked note by note, with a PDF of the diagrams."
            },
            {
              "description": "Piano chord chart with a slash chord",
              "prompt": "Piano chord chart for Cmaj7, Dm7, G7 and Fmaj7/A",
              "tools_triggered": "generate_chord_chart",
              "expected_behavior": "Calls generate_chord_chart with instrument piano. Cmaj7 is C4 E4 G4 B4, Dm7 is D4 F4 A4 C5, G7 is G4 B4 D5 F5 and Fmaj7/A has A3 in the left hand under F4 A4 C5 E5. Returns a PDF link."
            },
            {
              "description": "Transpose a pasted song and use a capo",
              "prompt": "Transpose this to A and give me capo shapes: Key: G / G Em C D. Make a guitar chord chart",
              "tools_triggered": "generate_chord_chart",
              "expected_behavior": "Calls generate_chord_chart with chords [G, Em, C, D], to_key A and capo auto. The chords become A, F#m, D, E (+2 semitones) and capo 2 gives the G, Em, C and D shapes. Returns a PDF link."
            },
            {
              "description": "Left-handed ukulele chart, 6 per page",
              "prompt": "Left-handed ukulele chord chart for C, G, Am and F, 6 per page on A4",
              "tools_triggered": "generate_chord_chart",
              "expected_behavior": "Calls generate_chord_chart with instrument ukulele, left_handed true, per_page 6, paper a4. C is 0003 (G C E C), G is 0232 (G D G B), Am is 2000 (A C E A), F is 2010 (A C F A), drawn mirrored. Returns a PDF link."
            }
          ],
          "negative": [
            {
              "description": "Bass guitar tab is out of scope. Expected: the tool is not called, or the assistant explains that only guitar, ukulele and piano chord diagrams are drawn.",
              "prompt": "Write the bass tab for Another One Bites the Dust"
            },
            {
              "description": "Music theory question without a chart. Expected: the assistant answers in chat without calling the tool.",
              "prompt": "What is the difference between a major and a minor chord?"
            },
            {
              "description": "Audio is out of scope. Expected: the tool is not called; the assistant says it cannot play sounds.",
              "prompt": "Play me what a C major chord sounds like"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://chord-charts.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: guitar, ukulele and piano chord diagram PDFs with note-checked shapes, chord sheet reading, transpose, capo, left-handed diagrams and 6, 12 or 24 diagrams per page.",
        "translations": {
          "pl-PL": {
            "subtitle": "Diagramy akord\u00f3w do druku",
            "description": "Wydrukuj tabel\u0119 akord\u00f3w gitarowych w kilka sekund: wy\u015blij list\u0119 akord\u00f3w albo wklej piosenk\u0119 z akordami, a Zovo Chord Chart Maker narysuje gotowy do druku PDF z diagramami akord\u00f3w na gitar\u0119 w stroju standardowym, ukulele w stroju G C E A albo klawiatur\u0119 pianina.\n\nKa\u017cdy chwyt na gitar\u0119 i ukulele jest sprawdzany przed wydrukiem: narz\u0119dzie oblicza d\u017awi\u0119k na ka\u017cdej strunie i zostawia chwyt tylko wtedy, gdy ka\u017cdy d\u017awi\u0119k nale\u017cy do akordu, a pryma jest obecna. Nazwy d\u017awi\u0119k\u00f3w s\u0105 drukowane pod strunami. Diagramy pianina s\u0105 liczone z interwa\u0142\u00f3w akordu.\n\nCzyta nazwy akord\u00f3w tak, jak zapisuj\u0105 je \u015bpiewniki (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E), a tak\u017ce wszystkie akordy z wklejonego tekstu piosenki. Mo\u017ce transponowa\u0107, pokaza\u0107 chwyty z kapodastrem, zaproponowa\u0107 pr\u00f3g kapodastra z naj\u0142atwiejszymi chwytami, odbi\u0107 diagramy dla lewor\u0119cznych i zmie\u015bci\u0107 6, 12 lub 24 diagramy na stronie Letter lub A4.\n\nOgraniczenia: tylko gitara w stroju standardowym, ukulele G C E A i pianino. Bez innych stroj\u00f3w, gitary basowej, mandoliny i banjo. Nieobs\u0142ugiwane typy akord\u00f3w s\u0105 wymienione i pomini\u0119te, a nie zgadywane. Nie tworzy tabulatur, nut ani d\u017awi\u0119ku."
          },
          "de-DE": {
            "subtitle": "Akkorddiagramme zum Drucken",
            "description": "Erstelle in Sekunden eine druckbare Gitarren-Akkordtabelle: Schicke eine Liste von Akkorden oder f\u00fcge einen Song mit Akkorden ein, und Zovo Chord Chart Maker zeichnet ein druckfertiges PDF mit Akkorddiagrammen f\u00fcr Gitarre in Standardstimmung, Ukulele in G C E A oder Klavier.\n\nJeder Gitarren- und Ukulele-Griff wird vor dem Druck gepr\u00fcft: Das Werkzeug berechnet den Ton auf jeder Saite und beh\u00e4lt einen Griff nur, wenn jeder Ton zum Akkord geh\u00f6rt und der Grundton vorhanden ist. Die Tonnamen stehen unter den Saiten. Klavierdiagramme werden aus den Intervallen des Akkords berechnet.\n\nEs liest Akkordnamen so, wie Songbooks sie schreiben (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E), auch aus einem eingef\u00fcgten Songtext. Es kann transponieren, Kapodaster-Griffe zeigen, den Bund mit den leichtesten offenen Griffen vorschlagen, Diagramme f\u00fcr Linksh\u00e4nder spiegeln und 6, 12 oder 24 Diagramme pro Seite auf Letter oder A4 setzen.\n\nGrenzen: nur Gitarre in Standardstimmung, Ukulele G C E A und Klavier. Keine anderen Stimmungen, kein Bass, keine Mandoline, kein Banjo. Nicht unterst\u00fctzte Akkordtypen werden aufgelistet und \u00fcbersprungen, nicht geraten. Keine Tabs, Noten oder Audio."
          },
          "es-ES": {
            "subtitle": "Diagramas de acordes",
            "description": "Crea en segundos una tabla de acordes de guitarra para imprimir: env\u00eda una lista de acordes o pega una canci\u00f3n con acordes, y Zovo Chord Chart Maker dibuja un PDF listo para imprimir con diagramas de acordes para guitarra en afinaci\u00f3n est\u00e1ndar, ukelele en G C E A o teclado de piano.\n\nCada posici\u00f3n de guitarra y ukelele se comprueba antes de imprimir: la herramienta calcula la nota de cada cuerda y conserva la posici\u00f3n solo si todas las notas pertenecen al acorde y la fundamental est\u00e1 presente. Los nombres de las notas aparecen bajo las cuerdas. Los diagramas de piano se calculan a partir de los intervalos del acorde.\n\nLee los acordes como los escriben los cancioneros (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E), tambi\u00e9n desde una canci\u00f3n pegada. Puede transponer, mostrar posiciones con cejilla, sugerir el traste de cejilla con las posiciones abiertas m\u00e1s f\u00e1ciles, reflejar los diagramas para zurdos y poner 6, 12 o 24 diagramas por p\u00e1gina en Letter o A4.\n\nL\u00edmites: solo guitarra en afinaci\u00f3n est\u00e1ndar, ukelele G C E A y piano. Sin otras afinaciones, bajo, mandolina ni banjo. Los tipos de acorde no admitidos se listan y se omiten, no se adivinan. No crea tablaturas, partituras ni audio."
          },
          "fr-FR": {
            "subtitle": "Diagrammes d'accords",
            "description": "Cr\u00e9ez en quelques secondes une grille d'accords de guitare \u00e0 imprimer : envoyez une liste d'accords ou collez une chanson avec ses accords, et Zovo Chord Chart Maker dessine un PDF pr\u00eat \u00e0 imprimer avec des diagrammes d'accords pour guitare en accordage standard, ukul\u00e9l\u00e9 en G C E A ou clavier de piano.\n\nChaque position de guitare et de ukul\u00e9l\u00e9 est v\u00e9rifi\u00e9e avant l'impression : l'outil calcule la note de chaque corde et ne garde la position que si chaque note appartient \u00e0 l'accord et que la fondamentale est pr\u00e9sente. Le nom des notes est imprim\u00e9 sous les cordes. Les diagrammes de piano sont calcul\u00e9s \u00e0 partir des intervalles de l'accord.\n\nIl lit les accords tels que les recueils les \u00e9crivent (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E), y compris dans une chanson coll\u00e9e. Il peut transposer, montrer les positions avec capodastre, proposer la case de capodastre aux positions ouvertes les plus simples, inverser les diagrammes pour gauchers et placer 6, 12 ou 24 diagrammes par page en Letter ou A4.\n\nLimites : guitare en accordage standard, ukul\u00e9l\u00e9 G C E A et piano uniquement. Pas d'autres accordages, ni basse, mandoline ou banjo. Les types d'accords non pris en charge sont list\u00e9s et ignor\u00e9s, jamais devin\u00e9s. Pas de tablature, de partition ni d'audio."
          },
          "ja-JP": {
            "subtitle": "\u5370\u5237\u7528\u30b3\u30fc\u30c9\u30c0\u30a4\u30a2\u30b0\u30e9\u30e0",
            "description": "\u5370\u5237\u3067\u304d\u308b\u30ae\u30bf\u30fc\u30b3\u30fc\u30c9\u8868\u3092\u3059\u3050\u306b\u4f5c\u6210\u3002\u30b3\u30fc\u30c9\u306e\u30ea\u30b9\u30c8\u3092\u9001\u308b\u304b\u3001\u30b3\u30fc\u30c9\u4ed8\u304d\u306e\u6b4c\u8a5e\u3092\u8cbc\u308a\u4ed8\u3051\u308b\u3068\u3001Zovo Chord Chart Maker \u304c\u30b9\u30bf\u30f3\u30c0\u30fc\u30c9\u30c1\u30e5\u30fc\u30cb\u30f3\u30b0\u306e\u30ae\u30bf\u30fc\u3001G C E A \u306e\u30a6\u30af\u30ec\u30ec\u3001\u307e\u305f\u306f\u30d4\u30a2\u30ce\u9375\u76e4\u306e\u30b3\u30fc\u30c9\u30c0\u30a4\u30a2\u30b0\u30e9\u30e0\u3092\u5370\u5237\u7528 PDF \u306b\u3057\u307e\u3059\u3002\n\n\u30ae\u30bf\u30fc\u3068\u30a6\u30af\u30ec\u30ec\u306e\u62bc\u3055\u3048\u65b9\u306f\u5370\u5237\u524d\u306b\u3059\u3079\u3066\u78ba\u8a8d\u3057\u307e\u3059\u3002\u5404\u5f26\u306e\u97f3\u3092\u8a08\u7b97\u3057\u3001\u3059\u3079\u3066\u306e\u97f3\u304c\u30b3\u30fc\u30c9\u306b\u542b\u307e\u308c\u3001\u30eb\u30fc\u30c8\u97f3\u304c\u3042\u308b\u3068\u304d\u3060\u3051\u63a1\u7528\u3057\u307e\u3059\u3002\u5f26\u306e\u4e0b\u306b\u97f3\u540d\u3092\u5370\u5237\u3057\u307e\u3059\u3002\u30d4\u30a2\u30ce\u306e\u56f3\u306f\u30b3\u30fc\u30c9\u306e\u97f3\u7a0b\u304b\u3089\u8a08\u7b97\u3057\u307e\u3059\u3002\n\nAm7\u3001F#m7b5\u3001Bbmaj7\u3001Dsus4\u3001G6/9\u3001C/E \u306a\u3069\u4e00\u822c\u7684\u306a\u8868\u8a18\u3092\u8aad\u307f\u53d6\u308a\u3001\u8cbc\u308a\u4ed8\u3051\u305f\u6b4c\u8a5e\u304b\u3089\u3082\u30b3\u30fc\u30c9\u3092\u62fe\u3044\u307e\u3059\u3002\u79fb\u8abf\u3001\u30ab\u30dd\u4f7f\u7528\u6642\u306e\u62bc\u3055\u3048\u65b9\u3001\u6700\u3082\u7c21\u5358\u306a\u30aa\u30fc\u30d7\u30f3\u30b3\u30fc\u30c9\u306b\u306a\u308b\u30ab\u30dd\u4f4d\u7f6e\u306e\u63d0\u6848\u3001\u5de6\u5229\u304d\u7528\u306e\u53cd\u8ee2\u56f3\u30011\u30da\u30fc\u30b8\u3042\u305f\u308a 6\u30fb12\u30fb24 \u500b\u306e\u914d\u7f6e(Letter \u307e\u305f\u306f A4)\u306b\u5bfe\u5fdc\u3057\u307e\u3059\u3002\n\n\u5236\u9650:\u30ae\u30bf\u30fc\u306f\u30b9\u30bf\u30f3\u30c0\u30fc\u30c9\u30c1\u30e5\u30fc\u30cb\u30f3\u30b0\u3001\u30a6\u30af\u30ec\u30ec\u306f G C E A\u3001\u30d4\u30a2\u30ce\u306e\u307f\u3002\u5909\u5247\u30c1\u30e5\u30fc\u30cb\u30f3\u30b0\u3001\u30d9\u30fc\u30b9\u3001\u30de\u30f3\u30c9\u30ea\u30f3\u3001\u30d0\u30f3\u30b8\u30e7\u30fc\u306b\u306f\u5bfe\u5fdc\u3057\u307e\u305b\u3093\u3002\u672a\u5bfe\u5fdc\u306e\u30b3\u30fc\u30c9\u306f\u63a8\u6e2c\u305b\u305a\u3001\u4e00\u89a7\u306b\u3057\u3066\u7701\u304d\u307e\u3059\u3002\u30bf\u30d6\u8b5c\u3001\u697d\u8b5c\u3001\u97f3\u58f0\u306f\u4f5c\u308a\u307e\u305b\u3093\u3002"
          },
          "pt-BR": {
            "subtitle": "Diagramas de acordes",
            "description": "Crie em segundos uma tabela de acordes de viol\u00e3o para imprimir: envie uma lista de acordes ou cole uma m\u00fasica com cifras, e o Zovo Chord Chart Maker desenha um PDF pronto para impress\u00e3o com diagramas de acordes para viol\u00e3o ou guitarra em afina\u00e7\u00e3o padr\u00e3o, ukulele em G C E A ou teclado de piano.\n\nCada posi\u00e7\u00e3o de viol\u00e3o e ukulele \u00e9 conferida antes da impress\u00e3o: a ferramenta calcula a nota de cada corda e s\u00f3 mant\u00e9m a posi\u00e7\u00e3o quando todas as notas pertencem ao acorde e a t\u00f4nica est\u00e1 presente. Os nomes das notas aparecem sob as cordas. Os diagramas de piano s\u00e3o calculados a partir dos intervalos do acorde.\n\nL\u00ea as cifras como os songbooks escrevem (Am7, F#m7b5, Bbmaj7, Dsus4, G6/9, C/E), inclusive de uma m\u00fasica colada. Pode transpor, mostrar formas com capotraste, sugerir a casa do capotraste com as formas abertas mais f\u00e1ceis, espelhar os diagramas para canhotos e colocar 6, 12 ou 24 diagramas por p\u00e1gina em Letter ou A4.\n\nLimites: apenas viol\u00e3o em afina\u00e7\u00e3o padr\u00e3o, ukulele G C E A e piano. Sem outras afina\u00e7\u00f5es, baixo, bandolim ou banjo. Tipos de acorde n\u00e3o suportados s\u00e3o listados e pulados, n\u00e3o adivinhados. N\u00e3o gera tablatura, partitura nem \u00e1udio."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}