Authoring VPhone Patch Sets
Lakr233/vphone-cli
Explains how to declare a firmware patch in a vphone patch set, add a new set, or write a preset, including naming, gating and the checks that catch undeclared patches.
Adds a Commodore 64 program, cartridge, SID or picture to TeensyROM's built-in menu by converting it to a PROGMEM header and wiring it into MainMenuItems.h.
Install TeensyROM Menu Program Adder
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-program --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-menu-program .claude/skills/add-menu-program && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .claude/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-programType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-program --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/add-menu-program .agents/skills/add-menu-program && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .agents/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-program --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/add-menu-program .cursor/skills/add-menu-program && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .cursor/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/SensoriumEmbedded/TeensyROM.git --path .claude/skills/add-menu-program--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-program --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/add-menu-program .gemini/skills/add-menu-program && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .gemini/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-programInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/add-menu-program .github/skills/add-menu-program && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .github/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install SensoriumEmbedded/TeensyROM add-menu-program --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SensoriumEmbedded/TeensyROM.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/add-menu-program .opencode/skills/add-menu-program && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "add-menu-program" agent skill from https://github.com/SensoriumEmbedded/TeensyROM/tree/main/.claude/skills/add-menu-program into .opencode/skills/add-menu-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-menu-program", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
add-menu-program- GitHub stars
- 227
- Token cost
- ~1.2k tokens
- SKILL.md length
- 575 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
Adds a Commodore 64 program, cartridge, SID or picture to TeensyROM's built-in menu by converting it to a PROGMEM header and wiring it into MainMenuItems.h.
- Works in 4 steps: Get what you need up front → Convert the binary to a header → Place the header → …
- Adding a game, demo or cartridge image to the TeensyROM menu
- SKILL.md covers 0. Get what you need up front, 1. Convert the binary to a…, 2. Place the header and 3. Wire it into MainMenuItems.h
- Calls node
What it does
TeensyROM compiles its menu content into the firmware as PROGMEM byte arrays, so adding a file means converting it to a header, placing the header where the build expects it, and wiring it into `MainMenuItems.h`. The agent starts by asking for anything missing: the source file, which existing menu directory it belongs in, the display name for the menu, which is free text and often differs from the filename, and a target folder if not the default.
Conversion uses `node tools/bin2header.mjs -t PROGMEM` on the file, which writes a header next to the source, with the array name taken from the filename. If the filename starts with a digit, the name must be overridden with `-n` so it begins with a letter, following the existing convention, and the generated declaration is checked for the PROGMEM static const form. The header then goes in `Source/Teensy/TRMenuFiles/ROMs/` by default, or the text, SID or picture folders, followed by two edits in `Source/Teensy/MainMenuItems.h`.
When your agent uses it
- Adding a game, demo or cartridge image to the TeensyROM menu
- Embedding a SID tune or picture file in the firmware menu
- Fixing an array name that breaks the build after converting a binary
Example prompts
- “Add Space Taxi.prg to the TeensyROM menu and show it as Space Taxi (1984).”
- “Convert this .crt cartridge to a header and wire it into the ROMs section.”
- “The converted file starts with a number and the array name fails to compile. Fix it.”
Requirements
- Node.js, to run tools/bin2header.mjs
- A checkout of the TeensyROM repository
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 28f6aa8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
TeensyROM Menu Program Adder loads about 1.2k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 575 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from SensoriumEmbedded/TeensyROM at commit 28f6aa8, republished under its MIT licence (© SensoriumEmbedded). 575 words, ~1,186 tokens.
Download SKILL.mdSave it as
.claude/skills/add-menu-program/SKILL.md (or your agent's skills folder).- name
- add-menu-program
- description
- Steps for adding a C64 program/binary to TeensyROM's built-in menu (converting a .prg/.crt/.bin into a PROGMEM header via tools/bin2header.mjs, dropping it into Source/Teensy/TRMenuFiles/, and wiring it into MainMenuItems.h). Use this whenever the user wants to add a program, game, demo, cart, SID, or picture file to the TeensyROM menu, or asks to "add X to the menu" / "add a new ROM" for this project.
Adding a program to TeensyROM's built-in menu
TeensyROM embeds its menu content as PROGMEM byte arrays compiled directly into the
firmware. Adding a file means: convert it to a header, drop the header where the build
expects it, then wire two things into MainMenuItems.h.
0. Get what you need up front
Ask for whatever isn't given:
- The source file (a
.prgin the common case; could be.crt/.bin/.sid/.klaetc.) - Which existing menu directory it goes in (see the mapping below — if the user names a
directory that doesn't obviously match, check the table at the bottom of
Source/Teensy/MainMenuItems.hrather than guessing) - The display name to show in the TeensyROM menu (this is free text the user chooses — often quite different from the filename, don't just reuse the filename)
- Target directory for the header file, if not the default (
Source/Teensy/TRMenuFiles/ROMs/)
1. Convert the binary to a header
node tools/bin2header.mjs -t PROGMEM "<path-to-file>"This writes <file>.h next to the source (e.g. MyProg.prg → MyProg.prg.h) unless -o
is given. The array name (-n) defaults to the filename with . replaced by _ — this
is the identifier you'll reference in step 3, so don't rename it after the fact without
also updating the reference.
Gotcha — check the first character of the filename before running. If it starts with a
digit, the default array name would start with _, which collides with C's reserved-
identifier rules. The existing convention in this codebase (see a586220ast_Diagnostics.h,
a781220_Dead_Test.h) is to override with -n "a<name>" instead — a leading letter, not an
underscore.
Verify PROGMEM actually landed correctly. Open the generated .h and check the array
declaration line reads exactly:
PROGMEM static const unsigned char <hname>[] = {tools/bin2header.mjs adds the space after -t PROGMEM for you (the old Python script did
not, and produced PROGMEMstatic const...), so this check is a sanity check rather than a
known trap.
2. Place the header
Move/copy the generated .h into Source/Teensy/TRMenuFiles/ROMs/ (the default for
programs/carts/binaries) unless the user specified a different subfolder — the codebase
also uses TRMenuFiles/Text_PETSCII/, TRMenuFiles/SIDs/, and TRMenuFiles/Pics/ for
those respective content types.
Show full SKILL.md (249 more words)Show less
3. Wire it into MainMenuItems.h
Two edits, both in Source/Teensy/MainMenuItems.h:
a) Add the #include, grouped with the other includes of the same content type near
the top of the file:
#include "TRMenuFiles/ROMs/<file>.h"b) Add a row at the bottom of the target directory's array. Each menu directory is a
StructMenuItem dir<Name>[] array. Find the right one from the human-readable name using
the top-level directory table near the end of the file (around line ~313), which maps
display names to array identifiers, e.g.:
rtDirectory, IOH_None, (char*)"/Utilities", (uint8_t*)dirUtilities, sizeof(dirUtilities),tells you "Utilities" is dirUtilities. Append a new row at the bottom of that array,
matching its existing column alignment:
rtFilePrg , IOH_None , (char*)"<Display Name>" , (uint8_t*)<hname> , sizeof(<hname>) ,rtFilePrgis correct for a plain.prg; usertFileCrt/rtFileSID/rtFileKla/rtBin16k/rtBin8kHi/rtBin8kLoetc. to match the source format — check a sibling entry in the same array for the type actually used for that format.IOH_Noneis correct unless the program needs a specific IO handler active while it runs (e.g.IOH_Swiftlinkfor a terminal program,IOH_TR_BASICfor BASIC-with-TR-commands) — if unsure, ask, or check what a similar existing entry uses.<hname>must be the exact array name bin2header generated (or the-noverride), used identically for both the pointer cast and thesizeof().
That's the whole change — sizeof(dir<Name>) in the top-level directory table is computed
automatically, so nothing else needs to be touched for a program going into an existing
directory. (Adding a new top-level directory, rather than a program inside an existing
one, would also need a new row in that top-level table — out of scope for this checklist
unless asked.)
© SensoriumEmbedded, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/add-menu-program of SensoriumEmbedded/TeensyROM.
Open the folder on GitHubat commit 28f6aa8
Compare with similar skills
TeensyROM Menu Program Adder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| TeensyROM Menu Program Adder this skillSensoriumEmbedded/TeensyROM | 227 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Authoring VPhone Patch SetsLakr233/vphone-cli | 15k | — | ~4.6k | Automated safety check: Pass | MIT | |
| Sipeed I2C and SPI Hardware Controlsipeed/picoclaw | 30k | — | ~578 | Automated safety check: Pass | MIT | |
| RuView Hardware Setupruvnet/RuView | 97k | — | ~1.8k | Automated safety check: Notes | MIT | |
| Esp32 Firmware Engineeralxv2016/folloup-sticky | 116 | 1 repos | ~3.8k | Automated safety check: Pass | GPL-3.0 | |
| ExecuTorch Binary Size Reductionpytorch/executorch | 5.1k | — | ~793 | Automated safety check: Pass | Custom licence |
Similar skills
Sipeed I2C and SPI Hardware Control
sipeed/picoclaw
Reads and controls I2C and SPI peripherals on Sipeed boards such as LicheeRV Nano, MaixCAM and NanoKVM through the i2c and spi tools.
RuView Hardware Setup
ruvnet/RuView
Brings a RuView CSI sensing node online by building ESP32-S3 or ESP32-C6 firmware, flashing the board, provisioning WiFi and checking the serial output.
Esp32 Firmware Engineer
alxv2016/folloup-sticky
ESP32 firmware engineering for ESP-IDF projects. An agent skill from alxv2016/folloup-sticky.
ExecuTorch Binary Size Reduction
pytorch/executorch
Measures and shrinks the ExecuTorch runtime binary by building a size test, analyzing it with bloaty and landing each reduction as its own pull request.
RuView mmWave Radar Setup
ruvnet/RuView
Sets up and runs 60 GHz and 24 GHz mmWave radar sensing on ESP32 boards in RuView, alone or fused with WiFi CSI.
More from SensoriumEmbedded/TeensyROM
TeensyROM IO Handler Checklist
SensoriumEmbedded/TeensyROM
Walks through adding a new cartridge or peripheral IO handler to TeensyROM's MinimalBoot firmware and the three files that must stay in sync.
Beyond Compare Git Diff Opener
SensoriumEmbedded/TeensyROM
Opens Beyond Compare on a git diff for the current work, a pull request, a branch, a commit or a range, without touching the checkout.
TeensyROM Build and Flash
SensoriumEmbedded/TeensyROM
Explains how to build the C64 menu programs and the dual-boot TeensyROM firmware from the repo and flash it to one or more boards over USB.
Related
Categories
Questions about TeensyROM Menu Program Adder
What does TeensyROM Menu Program Adder do?
Adds a Commodore 64 program, cartridge, SID or picture to TeensyROM's built-in menu by converting it to a PROGMEM header and wiring it into MainMenuItems.h. h`. The agent starts by asking for anything missing: the source file, which existing menu directory it belongs in, the display name for the menu, which is free text and often differs from the filename, and a target folder if not the default.
When should I use TeensyROM Menu Program Adder?
TeensyROM Menu Program Adder fits situations like: adding a game, demo or cartridge image to the TeensyROM menu; embedding a SID tune or picture file in the firmware menu; fixing an array name that breaks the build after converting a binary.
How do I install TeensyROM Menu Program Adder in Claude Code?
Run `npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a claude-code`. Or copy the skill folder (.claude/skills/add-menu-program in SensoriumEmbedded/TeensyROM) into .claude/skills/add-menu-program in your project. Claude Code loads it when a task matches its description.
How do I install TeensyROM Menu Program Adder in Codex?
Run `npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a codex`. Or copy the skill folder (.claude/skills/add-menu-program in SensoriumEmbedded/TeensyROM) into .agents/skills/add-menu-program in your project. Codex loads it when a task matches its description.
Can I use TeensyROM Menu Program Adder in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SensoriumEmbedded/TeensyROM --skill add-menu-program -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-menu-program, .gemini/skills/add-menu-program, .github/skills/add-menu-program and .opencode/skills/add-menu-program in your project.
What does TeensyROM Menu Program Adder need to run?
Going by SKILL.md and its folder, TeensyROM Menu Program Adder needs the command-line tools its instructions call (node). Our summary lists: Node.js, to run tools/bin2header.mjs; A checkout of the TeensyROM repository.
Does TeensyROM Menu Program Adder access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is TeensyROM Menu Program Adder safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does TeensyROM Menu Program Adder use?
TeensyROM Menu Program Adder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does TeensyROM Menu Program Adder use?
About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to TeensyROM Menu Program Adder?
Skills that share tags, products or a category with TeensyROM Menu Program Adder: Authoring VPhone Patch Sets (Lakr233/vphone-cli, 15k stars), Sipeed I2C and SPI Hardware Control (sipeed/picoclaw, 30k stars), RuView Hardware Setup (ruvnet/RuView, 97k stars) and Esp32 Firmware Engineer (alxv2016/folloup-sticky, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TeensyROM Menu Program Adder?
SensoriumEmbedded (a GitHub user) maintains it in SensoriumEmbedded/TeensyROM, which has 227 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 7, 2026.
Source: SensoriumEmbedded/TeensyROM on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.