git404hub

what is batocera-skills fr?

t3chnaztea/batocera-skills — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

tl;dr

Claude Code skills that teach an AI coding assistant how to operate and maintain a real Batocera retro arcade cabinet.

vibe map

mindmap
  root((batocera-skills))
    What it does
      SSH cabinet operations
      ROM curation
      Display and tuning fixes
    Tech stack
      Claude Code
      Agent Skills
      SSH
    Use cases
      Fix bezel display
      Diagnose lag
      Backup and upgrade safely
    Audience
      Arcade cabinet owners
      Retro gaming hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Have an AI assistant SSH into your arcade cabinet to fix a display or bezel issue.

VIBE 2

Diagnose a slow or laggy frontend, including a known power mode bug.

VIBE 3

Curate and verify your ROM library against known good file checksums.

VIBE 4

Back up your cabinet's data and safely survive a Batocera version upgrade.

what's the stack?

PythonMarkdownClaude CodeAgent Skills

how it stacks up fr

t3chnaztea/batocera-skills1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencegeneralvibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires SSH root access to a real Batocera cabinet, you should change its default password before use.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

This project packages a year of hands on experience running a real arcade cabinet into a set of skills for coding assistants like Claude Code. Batocera is a popular retro gaming operating system used to build home arcade cabinets, and while its wiki covers the basics, day to day tasks like curating a big game library, lining up bezel artwork, or keeping the system responsive after an update tend to rely on knowledge that only comes from experience. This repository turns that hard won knowledge into five focused, on demand guides your coding assistant can load when relevant. The first skill, batocera ops, covers connecting to the cabinet over SSH, understanding its file layout, and a safe way to verify changes remotely by launching something and taking a screenshot rather than needing a physical controller. The other four build on that foundation: batocera roms covers organizing your game files and checking that your copies match known good versions, batocera display covers shaders and bezel artwork alignment, batocera tuning covers fixing a slow or laggy system and a specific bug where the system gets stuck in a low power mode, and batocera maintenance covers running scheduled jobs, backing up your data, and safely surviving version upgrades. The skills are meant to be used with an AI coding assistant that has direct access to your cabinet over SSH as the root user, which is a significant level of access, so the author recommends reviewing what each skill does before installing and changing your cabinet's default password first. The included scripts are designed to be safe by default: many support a dry run mode, back up your settings before changing them, and avoid deleting files outright in favor of hiding them. It installs as a Claude Code plugin, or you can copy the skill folders manually into any compatible assistant's skills directory. It has been tested on Batocera versions 41 through 43 and is released under the MIT License.

prompts (copy fr)

prompt 1
Explain the read-only /userdata model and safety doctrine in batocera-ops.
prompt 2
Help me fix bezel alignment issues using the batocera-display skill.
prompt 3
Walk me through backing up my cabinet's userdata over SSH.
prompt 4
Show me how to diagnose the governor-stuck-in-powersave bug.

Frequently asked questions

what is batocera-skills fr?

Claude Code skills that teach an AI coding assistant how to operate and maintain a real Batocera retro arcade cabinet.

What language is batocera-skills written in?

Mainly Python. The stack also includes Python, Markdown, Claude Code.

What license does batocera-skills use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is batocera-skills to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is batocera-skills for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.