debug-raw-amxd

Inspect raw Max for Live AMXD patch files using a canonical Python CLI.

Updated Aug 9, 2026
One-click install
npx skills add https://github.com/CooperNederhood/Ableton-Agent-App --skill debug-raw-amxd-coopernederhood
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-raw-amxd
Source: https://github.com/CooperNederhood/Ableton-Agent-App/tree/main/.github/skills/debug-raw-amxd
Command: npx skills add https://github.com/CooperNederhood/Ableton-Agent-App --skill debug-raw-amxd-coopernederhood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When learning documents and the patch database lack exact details about a Max for Live device—such as outlet indices, box attributes, parameter ranges, or hidden subpatchers—this Skill lets you inspect the raw .amxd patch file directly to recover the missing facts. ## Core Features & Use Cases - Patch Inspection: Run summary, objects, lines, box, params, subs, and graph commands against any .amxd file to reveal its internal structure. - Wiring and Parameter Analysis: Use box and lines --obj for exact inlet/outlet wiring, and params for Live parameter metadata. - Hidden Subpatcher Discovery: Use subs and objects --recursive to expose patchers not visible in higher-level documentation. - Use Case: You are debugging a Max for Live device and the patch database does not record an outlet index. Run the amxd_debug.py lines command on the raw .amxd file to get the exact wiring, then update the canonical patch-learnings.md with the finding. ## Quick Start Ask the agent to inspect the raw AMXD patch file for a specific Max for Live device and report its object wiring and parameter metadata.

Frequently Asked Questions about debug-raw-amxd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inspect a raw Max for Live .amxd patch file?▼

Run the amxd_debug.py script with a subcommand such as summary, objects, lines, box, params, subs, or graph, passing the absolute path to the .amxd file. The MAX4LIVE_MCP_ROOT environment variable must point to the Max4Live-MCP repository root.

How to find exact inlet and outlet wiring in a Max for Live device?▼

Use the box command with a box varname, or the lines command with the --obj flag, against the raw .amxd file. These commands report exact inlet and outlet connections that higher-level documentation may omit.

When should I use raw AMXD inspection instead of the patch database?▼

Use raw inspection only when learning documents and the patch database do not capture an exact outlet index, box attribute, parameter range, or hidden subpatcher. It is a fallback debugging adapter, not the primary source.

Can I inspect user-saved Max for Live devices with this tool?▼

Yes. For user-saved devices, pass an absolute path located under the ABLETON_MAX_PATH directory instead of a path inside the max_knowledge learnings tree.

What should I do after discovering missing facts in an AMXD patch?▼

Update the canonical patch-learnings.md file with the discovered fact and re-ingest it. Do not write learning artifacts into the ableton-agent-app repository.