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.