macro-keyboard

macro-keyboard is a plugin for Claude Code from terrylica/cc-skills. Its manifest loads nothing; the 4 skills it bundles cost 319 tokens per session together, scanned A, original, MIT.

A macOS configuration guide for inexpensive three-key USB-C or Bluetooth macro pads, using Karabiner-Elements to remap their keys.

In plain words
What is it for?
Use it to configure per-device shortcuts, make a macro pad emit the Mac Fn key, and investigate USB or Bluetooth keyboard behavior.
Why use it?
It helps resolve device-specific key mappings and diagnose keycodes that macOS does not identify as expected.

Plugin for Claude Code

Written for Claude Code: a Claude Code plugin manifest.

Good fit Use it to configure per-device shortcuts, make a macro pad emit the Mac Fn key, and investigate USB or Bluetooth keyboard behavior.

Compare 6 plugins from other repositories ↓
Install in Claude Code
/plugin marketplace add terrylica/cc-skills
/plugin install macro-keyboard
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/terrylica/cc-skills

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for macro-keyboard

README.md
[![agentmods](https://agentmods.dev/badge/plugins/terrylica/cc-skills/macro-keyboard/github.svg)](https://agentmods.dev/plugins/terrylica/cc-skills/macro-keyboard)
Your own site
<a href="https://agentmods.dev/plugins/terrylica/cc-skills/macro-keyboard"><img src="https://agentmods.dev/badge/plugins/terrylica/cc-skills/macro-keyboard/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for macro-keyboard

Your own site · 80×15
<a href="https://agentmods.dev/plugins/terrylica/cc-skills/macro-keyboard"><img src="https://agentmods.dev/badge/plugins/terrylica/cc-skills/macro-keyboard.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session not measured What this adds to a session before it is invoked.
When invoked not measured The manifest loads nothing itself; its 4 skills cost 319 tokens a session between them.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Security

Grade A, and why

macro-keyboard scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude-plugin/marketplace.json#macro-keyboard · 54 lines

What it actually says

{
  "name": "macro-keyboard",
  "description": "Configure cheap 3-key USB-C/Bluetooth macro pads on macOS with Karabiner-Elements: emit real Fn, remap per-device, diagnose mystery keycodes, and diagnose a global hotkey that dies while a VNC viewer, VM or game is frontmost. Includes worked example: Jieli/Free3-P (VID 0x4c4a USB / 0x04E8 BT).",
  "version": "34.5.1",
  "source": "./plugins/macro-keyboard",
  "category": "productivity",
  "author": {
    "name": "terrylica",
    "url": "https://github.com/terrylica"
  },
  "keywords": [
    "macro-pad",
    "macro-keyboard",
    "3-key-pad",
    "stream-deck-alternative",
    "aliexpress-macropad",
    "karabiner",
    "karabiner-elements",
    "karabiner-rule",
    "hid",
    "hid-diagnostic",
    "hid-report-descriptor",
    "jieli",
    "free3-p",
    "realtek",
    "ch57x",
    "bluetooth-hid",
    "bluetooth-remap",
    "usb-to-bluetooth-remap",
    "samsung-vid-0x04e8",
    "fn-key",
    "fn-emission",
    "real-apple-fn",
    "apple-fn",
    "apple-vendor-top-case",
    "driverkit-virtualhiddevice",
    "typeless",
    "typeless-push-to-talk",
    "macos-dictation",
    "cgeventpost-fn-failure",
    "btt-fn-failure",
    "macos",
    "remap",
    "device-scoped",
    "device-if",
    "global-hotkey",
    "hotkey-not-working",
    "cgeventtap",
    "keyboard-grab",
    "vnc-viewer",
    "frontmost-application-if"
  ],
  "strict": false
}
Contents

What it installs

The manifest is a name and a version. 4 skills travel with it, and installing the plugin installs all of them — 319 tokens a session between them. Each is measured on its own page, and each can be installed alone.

Files

What ships with it

2 files beside marketplace.json#macro-keyboard in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed b08065182ca5
  2. yesterday Changed 81f153de832c
  3. 3d ago Changed 194b8f4a2593
  4. 5d ago Changed 02556d277532
  5. 6d ago Changed c9846bba8ada
  6. 7d ago Changed 0cd6bee05b95
  7. 9d ago Changed 629df8dccc1c
  8. 10d ago Changed · +6 lines acec25038978
  9. 12d ago Changed 878d26fe76e9
  10. 17d ago First seen · 48 lines scan A 369688cf1061

Subscribe to this mod's changes

macro-keyboard is a plugin published in the GitHub repository terrylica/cc-skills (0 stars, last pushed yesterday), licensed MIT. Its token cost is not measured: this kind of file is read by the harness, not the model. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-05.

Related

Other plugins, from other repositories

ralph-wiggum

Implementation of the Ralph Wiggum technique - continuous self-referential AI loops for interactive iterative development. Run Claude in a while-true loop with the same prompt until task completion.

travisjneuman/.claude · not measured

claude-skills-library marketplace

FrankX multi-brand plugin marketplace: the Agent Skills library plus validated brand packs for GenCreator creators and Starlight Academy.

frankxai/claude-skills-library · not measured

claude-skills-library

The complete library of Agent Skills — AI agents & orchestration, MCP & SDKs, Oracle & cloud, frontend & animation, engineering workflow, content & brand, and creative production. Skills auto-activate when relevant.

frankxai/claude-skills-library · not measured

brewcode

Brewcode - Claude Code authoring toolkit: skill, agent and rule creation and sync, semantic code search (semble), project conventions, E2E tests, generated review and domain-team skills, setup dashboard, post-compact plan re-anchor.

kochetkov-ma/claude-brewcode · not measured

attention-notify

Raise a local macOS banner for every PushNotification call and every attention-needed Notification event.

dryvist/claude-code-plugins · not measured

ltspice-mcp

MCP tools for LTspice/ngspice circuit simulation and LTspice .asc schematic editing. Structured results include per-device operating points (gm/gds/vth) by device name, without parsing raw files. Tracks the latest ltspice-mcp release on PyPI.

Cognitohazard/ltspice-mcp · not measured