Skip to content

Add a Claude Code and Codex compatible MFT skill #2

Description

@oveddan

Goal

Add a reusable repository skill that lets both Claude Code and Codex operate the MIDI Fighter Twister configurator safely and consistently.

Scope

  • Document device discovery, complete JSON export, offline plan generation, and guarded apply workflows.
  • Keep protocol and safety guidance in one canonical skill source.
  • Provide thin installation/adaptor instructions for both Claude Code and Codex instead of maintaining divergent copies.
  • Teach agents to inspect firmware identity and compatibility before proposing or applying changes.
  • Preserve the existing separation between read-only requests, configuration writes, and blocked system/reset/bootloader commands.
  • Include common recipes for colors, switch actions, MIDI mappings, four-bank devices, and optional eight-bank devices.

Acceptance criteria

  • A canonical SKILL.md exists in the repository with concise trigger guidance and task workflows.
  • The skill can be installed or linked for both Claude Code and Codex using documented commands.
  • Instructions use the project CLI rather than duplicating SysEx byte construction in prompts.
  • Read-only operations are the default; writes require an explicit user request and the existing guarded plan/apply flow.
  • Examples cover discovery, export, color changes, and toggle-button changes.
  • An unsupported or future firmware version is handled conservatively.
  • A smoke-test checklist demonstrates the skill being invoked successfully from both Claude Code and Codex.
  • Generated snapshots, plans, journals, and backups remain untracked.

Notes

The skill should remain useful if the CLI internals change, so it should reference stable commands and safety invariants rather than tightly coupling itself to individual TypeScript functions.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions