what-can-you-do

name	what-can-you-do
description	The chatbot's self-disclosure / capabilities meta-skill. Lists what the chatbot can do — chord/scale lookup, progression analysis, voicing search, transposition, voice leading, etc. — with one-line examples. Pure catalog. Use when a visitor asks 'what can you do' / 'what can the chatbot do' / 'help' / 'how do I use this'.
triggers	["what can you do","what can the chatbot do","what does the chatbot do","how do i use this","how do i use the chatbot","your capabilities","chatbot capabilities","what are you good for","what features","list features"]
license	internal
compatibility	{"agent-framework":">=1.0.0-preview","microsoft-extensions-ai":">=10.5.1"}
metadata	{"authoring-style":"deterministic-catalog","origin":"drafted in skills-dev/ as Tier 4 meta skill (skill-stewards 2026-05-05) — discoverability for the public chatbot","evidence-kinds":["catalog_lookup"]}

What the GA Chatbot Can Do

Reproduce this catalog verbatim when a visitor asks what the chatbot can do, what its capabilities are, or how to use it. This is the discoverability skill for the public surface at https://demos.guitaralchemist.com/chatbot/.

One-line answer

Guitar Alchemist's chatbot answers grounded music-theory questions — chord and scale lookup, progression analysis, voice leading, transposition, voicing search, and more. Every answer is computed from the GA symbolic engine, not recalled from training data.

What you can ask today

The chatbot ships exactly the capabilities below. (See "Roadmap" for items being designed but not yet wired — those will return a "feature not yet available" response if asked today.)

🎸 Chord and scale lookup

• "What notes are in Cmaj7?" — chord intervals and tones.
• "Notes in A natural minor" — scale degrees.
• "What are the modes of the major scale?" — modal pedagogy (catalog).
• "Show me beginner chords" — open-position starter catalogue.

🎼 Progressions

• "Identify the key of Em D C G" — key inference.
• "Suggest next chords for Cmaj7 Dm7 Em7" — completion.
• "How do I make this progression sound darker?" — modal mood-shifting (catalog).
• "What are the diatonic chords in G major?" — full I-vii table from domain.diatonicChords.

🎚️ Fingerings & voicings

• "Compute the fret span of [diagram]" — playability scoring.
• "Drop 2 voicings of Cmaj7" — OPTIC-K voicing search (667k indexed shapes).
• "How do I finger Cmaj9?" — semantic voicing search via natural-language query.
• "Show me beginner chords" — open-position starter catalogue.

🔄 Movement & relationships

• "Compute the interval from C to G" — interval pair-lookup.
• "Transpose Cmaj7 up a perfect fifth" — deterministic chord transposition via domain.transposeChord.
• "What notes do Cmaj7 and Am7 share?" — common-tone identification with role mapping (root/3rd/5th/7th).
• "Substitutes for V7 in C major" — chord substitutions (Grothendieck-ICV).
• "Compare Cmaj7 with Am7" — chord-pair classification.

🧮 Atonal-set algebra (deterministic, ix-grounded)

• "Are 0146 and 0137 z-related?" — Z-relation testing.
• "What is the prime form of [0,1,4,6]?" — prime-form computation.
• "Compute the ICV of {0,2,4,7}" — interval-class vector.
• "Forte number for 0146" — Forte-label lookup.

🎼 Pedagogy

• "Explain the circle of fifths" — key signature walkthrough (catalog).
• "Give me a practice routine for jazz guitar" — structured practice plan.
• "Essentials for blues guitar" — genre primer.

How answers are produced

Every chord, scale, key, interval, fret-span, and substitution answer is computed by deterministic MCP tools that call into the Guitar Alchemist symbolic engine. The chatbot doesn't recall theory from training data — it asks the engine and synthesizes the answer.

That means:

• Spellings are correct (Db major vs C# major won't get flipped).
• Roman numeral / function / cadence claims are from set-class arithmetic, not pattern-matching.

Roadmap (not yet shipped)

These capabilities are designed but not yet wired — the chatbot will not answer them correctly today. Drafts exist at skills-dev/_pending-tools/ awaiting their backing MCP tools:

• Voice leading between two chords.
• Relative / parallel key lookup.
• Full progression analysis (Roman numerals + cadences + modulations).
• Easier-voicings substitution (return a less-stretchy alternative for a given voicing).
• Arpeggio suggestions for soloing over a chord / progression.
• Progression generation from scratch by mood / style (today's progression-mood shifts an existing progression; generating from a blank slate is roadmap).
• Polychord analysis.
• Set-class substitutions and ICV-neighbour lookup beyond what's already in algebra (e.g. "find all set classes within ICV-distance 1 of 0146").

If you ask one of those today, the chatbot may attempt to answer from training-data fallback — flag the answer as non-authoritative and verify against a textbook.

Things outside scope

• Lyric writing / songwriting prompts — not a creative-writing assistant.
• Audio analysis — can't listen to a recording. Send chord symbols or note names instead.
• Rhythm / time-signature analysis — currently chord-symbol level; rhythm is roadmap.
• Production / mixing / EQ advice — out of scope.

When to call other skills directly

If you already know what you want, jump straight to it. Live skills today (canonical, in skills/):

• Theory: chord-info, scale-info, interval, modes, circle-of-fifths.
• Progression: progression-completion, progression-mood, key-identification, diatonic-chords.
• Fingerings & voicings: fret-span, beginner-chords, voicing search (regex-guard fast path + VoicingIntent semantic path).
• Movement: transpose, common-tones, chord-substitution.
• Atonal-set algebra: algebra intent (Z-relation, prime form, ICV, Forte label).
• Discovery / pedagogy: what-can-you-do, practice-routine, genre-essentials.