메뉴
Use when implementing EP-133 KO-II upload/download/delete/metadata operations, debugging SysEx messages, or working with 7-bit packed encoding. Does NOT cover device organization (slots/banks/pads) — see ep133-device for that.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | ep133-protocol |
| description | Use when implementing EP-133 KO-II upload/download/delete/metadata operations, debugging SysEx messages, or working with 7-bit packed encoding. Does NOT cover device organization (slots/banks/pads) — see ep133-device for that. |
| spec-commit | 53ccc08 |
Reverse-engineered. No official documentation exists. All findings from capture analysis and working implementation in this repo.
F0 00 20 76 33 40 [devid] [seq] 05 <packed7(raw_payload)> F7
TE mfr ID EP-133
00 20 76 — Teenage Engineering manufacturer ID33 40 — EP-133 device family[devid] — Session identifier byte. Device echoes it back with -0x40 offset in responses. Any value works — official TE app rotates 0x60–0x6A, our tool uses fixed values per operation type.[seq] — Sequence byte, increments 0–127 then wraps (instance variable _seq)05 — CMD_FILE (file operations group)SysExCmd enum in src/core/models.py)These are NOT opcodes — the device accepts any value. We use consistent IDs for predictable response matching.
| ID | Name | Our usage |
|---|---|---|
| 0x61 | INIT | Initialization sequence |
| 0x77 | INFO | Device info queries |
| 0x75 | GET_META | Legacy metadata query — unreliable, do not use |
| 0x7C | PROJECT | Project switching |
| 0x7E | UPLOAD | Upload (all steps), delete, verify |
| 0x7D | DOWNLOAD | File download (GET) |
| 0x6A | LIST_FILES | File ops (LIST/METADATA/AUDITION) |
Device response ID = request ID - 0x40 (e.g., TX 0x7E → RX 0x3E).
FileOp enum)| Op | Name | Usage |
|---|---|---|
| 0x02 | PUT | Upload file |
| 0x03 | GET | Download file |
| 0x04 | LIST | List files |
| 0x05 | PLAYBACK | Playback/audition |
| 0x06 | DELETE | Delete sample |
| 0x07 | METADATA | Metadata GET/SET |
| 0x0B | VERIFY | Verify/commit |
F0 7E 7F 06 01 F7 # Universal MIDI identity
F0 00 20 76 33 40 61 17 01 F7 # Device handshake
F0 00 20 76 33 40 61 18 05 00 01 01 00 40 00 00 F7 # File system init
Init uses fixed seq bytes (0x17, 0x18), not the rolling _seq counter.
Evidence: tests/fixtures/sniffer-upload-kick-official.jsonl (official TE app, kick-46875hz.wav → slot 97). PCM byte-for-byte match verified.
F0 00 20 76 33 40 [devid] [seq] 05 <packed7(raw_payload)> F7
Raw payload (before packed7):
02 00 05 [slot_hi] [slot_lo] [node_hi] [node_lo] [size:4 BE] [name\0] [metadata_json]
02 = PUT, 00 = PUT_INIT, 05 = audio file type0x03E8 (1000 = /sounds/ directory){"channels":1,"samplerate":46875}Wait for ACK response before proceeding.
Raw payload: 02 01 [index_hi] [index_lo] [pcm_data...]
02 = PUT, 01 = PUT_DATAUPLOAD_CHUNK_SIZE)Raw payload: 02 01 [next_index_hi] [next_index_lo] (same format as data chunk, 0 PCM bytes)
VERIFY: 0B [slot_hi] [slot_lo] (3 bytes, NO sub byte)
META_SET: 07 01 [node_hi] [node_lo] [json]
VERIFY: 0B [slot_hi] [slot_lo] (repeat)
fileop + BE16(target)0x6A (LIST_FILES), not UPLOADCall _initialize() to resync device state. Official app does this too.
Implementation: src/core/operations.py → UploadTransaction.execute()
0x7D)F0 00 20 76 33 40 7D [seq] 05 00 03 00 [slot_hi] [slot_lo] 00 00 00 00 00 F7
03 = GET, 00 = GET_INIT0x7D)F0 00 20 76 33 40 7D [seq] 05 00 03 01 [page_lo] [page_hi] F7
file_info["size"] from GET_INIT response0x7E)Raw payload: 06 [slot_hi] [slot_lo]
06 = DELETE07 02 [node_hi] [node_lo] [page_hi] [page_lo])0x6A} found in accumulated JSON07 01 [node_hi] [node_lo] [json_data])0x6A{"active":<node>}, {"sym":<slot>}, {"sample.start":N,"sample.end":N}, {"channels":N,"samplerate":N}Returns stale/cached data. Official tool never uses it.
All large payloads must be packed7-encoded for MIDI SysEx safety.
Algorithm: for each group of up to 7 data bytes, prepend a flags byte where bit i holds the high bit of byte i. Implementation: src/core/types.py → Packed7.
PROTOCOL.md, docs/protocol-evidence.mdsrc/core/models.pysrc/core/client.pysrc/core/operations.pysrc/core/types.py → Packed7midi_proxy.py, scripts/capture_upload.pytests/fixtures/sniffer-upload-kick-official.jsonl (official TE app), tests/fixtures/sniffer-upload21.jsonlUse when deciding how to manage, audit, sync, enable, disable, or troubleshoot skills and agents with the skillshare CLI across Claude Code, Codex, Gemini, OpenCode, Kiro, Goose, Pi, Antigravity, or project-local .skillshare setups. Especially use for questions about global vs project mode, disabled-by-default policies, .skillignore/.agentignore, target drift, broken symlinks, duplicate skills, sync dry-runs, or whether to use skillshare versus a runtime-native tool such as Codex skill-manager.
Use when creating git commits or reviewing commit messages. Ensures messages follow the Conventional Commits specification v1.0.0, which enables automated changelogs and semantic versioning. Invoked when the user wants to commit changes, craft a commit message, or validate an existing one.
Use when user references previous work phases, tasks, or discussions from prior sessions not present in current conversation context.
Use when designing or reviewing Python classes, deciding where logic belongs, or recognizing antipatterns like helper classes, utility bags, and god objects.
Use when crafting prompts that require factual accuracy, working with long documents, generating claims that need verification, or when outputs must be auditable and grounded in source material
Use when transitioning between work sessions and wanting to pick up where the previous session left off.