这是一个代理技能，教AI编码代理如何用Ableton Extensions SDK（@ableton-extensions/sdk，TypeScript）架构、编写、构建和打包**Ableton Live扩展*。

安装后，你可以问代理类似*“创建一个Ableton扩展，将选定的MIDI剪辑移调一个八度”*，它会用真实的SDK的API、约定和工具生成正确且可构建的项目——而不是猜测。

它遵循开放的Agent Skills惯例——一个SKILL.md文件及支持的参考文档——因此任何理解该格式的代理都可以使用它。以下安装说明适用于Claude代码;为加载技能的其他代理调整路径。

---

它的作用

该技能为代理提供了准确且版本钉定的SDK知识，使其能够：

• Scaffold 一个新的扩展项目（manifest、build config、entry点）。
• 编写使用真实对象模型的扩展代码——轨道、剪辑、MIDI音符、设备、速度、场景、选段。
• 添加UI — 右键点击的右键菜单操作、模态对话框（WebView HTML）和进度对话框。

Ableton Extensions Skill

An Agent Skill that teaches an AI coding agent how to scaffold, write, build, and package Ableton Live extensions with the Ableton Extensions SDK (@ableton-extensions/sdk, TypeScript).

When this skill is installed, you can ask your agent things like “create an Ableton extension that transposes the selected MIDI clip up an octave” and it will produce a correct, buildable project using the real SDK APIs, conventions, and tooling — instead of guessing.

It follows the open Agent Skills convention — a SKILL.md file plus supporting reference docs — so any agent that understands that format can use it. Installation instructions below are for Claude Code; adapt the path for other agents that load skills.

---

What it does

The skill gives the agent accurate, version-pinned knowledge of the SDK so it can:

• Scaffold a new extension project (manifest, build config, entry point).
• Write extension code using the real object model — tracks, clips, MIDI notes, devices, tempo, scenes, selections.
• Add UI — right-click context-menu actions, modal dialogs (WebView HTML), and progress dialogs.
• Build & package — bundle with esbuild and produce a distributable .ablx archive.
• Stay within the SDK’s boundaries — it knows extensions are an offline editing/automation layer, not a real-time MIDI/audio effect (that’s a job for Live’s built-in MIDI effects or Max for Live).

---

How it works

Agent Skills use progressive disclosure: a small always-loaded entry file points to larger references that the agent reads only when relevant. This keeps context lean.

ableton-extensions-skill/
├── SKILL.md                  # entry point — always loaded; frontmatter triggers the skill
├── README.md                 # this file (human-facing; not loaded by the agent)
└── reference/                # loaded on demand, when the agent needs the detail
    ├── scaffolding.md        # create a project, manifest/package/build configs, CLI, .env, debugging, packaging
    ├── api.md                # the full object model: ExtensionContext, Song/Track/Clip/MidiClip, enums, scopes
    └── recipes.md            # copy-paste code for context menus, dialogs, note/clip edits, transactions

• SKILL.md has YAML frontmatter (name, description). The agent reads the description to decide when to activate the skill (e.g. a request mentions an Ableton extension, MIDI clip editing, a context-menu action). Its body covers the entry-point shape, core concepts, and the workflow.
• reference/*.md are pulled in only when needed — e.g. the agent opens reference/recipes.md when writing a modal dialog, or reference/scaffolding.md when setting up the build.

---

What you need to download / install