batocera-display SKILL.md skillA

batocera-display from t3chnaztea/batocera-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add t3chnaztea/batocera-skills/batocera-display@git:20260704.d32e8c6

Pins git:20260704.d32e8c6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
t3chnaztea/batocera-skills
Path
skills/batocera-display/SKILL.md
Versions recorded
1
Latest version
git:20260704.d32e8c6, committed Jul 4, 2026
Size
6,936 bytes
Repository stars
4
License
MIT

Use when working on how games look on a Batocera cabinet: CRT and other shaders, shaderset resolution and per-game shader overrides, bezel/overlay artwork and alignment, generating missing .info sidecars, filtering unusable bezels, pinning the display resolution, or diagnosing moire and cropped/misaligned game viewports inside bezels. Covers why a shaderset seems invalid, why .info top values are not alpha coordinates, and why Mega-Bezel per-game art fails. Not for performance/framerate tuning…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Batocera Display

Shaders, bezels, and display mode — everything about how the picture looks.
Assumes the connection pattern, `batocera.conf`/configgen model, and verify loop
from `batocera-ops`. Because display changes are visual, the
`batocera-ops` **remote verify loop** (ES HTTP API launch + `batocera-screenshot`)
is your primary tool here: never declare a shader or bezel "working" from the
config alone — launch it and look.

## Shaders

Shaders are assigned per-system (or per-game) in `batocera.conf`. Two key
mechanisms and the traps around each.

### `shaderset` resolves against TWO search paths

`<system>.shaderset=<name>` is a **folder-name lookup** resolved against both:

1. `/userdata/shaders/configs/<name>/` (user-installed)
2. `/usr/share/batocera/shaders/configs/<name>/` (system-bundled)

Checking only one path is enough to wrongly declare a preset invalid. Some
built-in names are aliases that resolve to a preset deep under
`/usr/share/batocera/shaders/`. Before concluding a `shaderset` value is dead:

```bash
SSHB "find /userdata/shaders /usr/share/batocera/shaders -maxdepth 3 -iname '<name>*'"
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add t3chnaztea/batocera-skills/batocera-display@sha256:53f77149bde82741

The line at the top of this page pins the label git:20260704.d32e8c6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wwswywb6adyecgko.svg)](https://markdownregistry.com/a/art_wwswywb6adyecgko)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 4, 2026.

versioncommittedcommitsizeaudit
git:20260704.d32e8c6 latest2026-07-04 d32e8c6 6,936 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6936 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

t3chnaztea/batocera-skills · 4 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wwswywb6adyecgko
GET https://markdownregistry.com/api/v1/resolve?ref=t3chnaztea/batocera-skills/batocera-display
GET https://markdownregistry.com/api/v1/blob/53f77149bde827415c13bc5b97700e7f1de9080d623d9957c9f96db7de198861

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from t3chnaztea/batocera-skills

batocera-maintenance SKILL.md skill
t3chnaztea/batocera-skills · skills/batocera-maintenance/SKILL.md · Use when keeping a Batocera cabinet healthy over time: running scripts or scheduled jobs at boot and on an interval…
git:20260704.d32e8c6 · audit A · 4 stars
batocera-ops SKILL.md skill
t3chnaztea/batocera-skills · skills/batocera-ops/SKILL.md · Use when connecting to or operating a Batocera arcade/retro-gaming cabinet over SSH: establishing the connection…
git:20260704.7dd30bb · audit B · 4 stars
batocera-roms SKILL.md skill
t3chnaztea/batocera-skills · skills/batocera-roms/SKILL.md · Use when working with ROMs and gamelists on a Batocera cabinet: figuring out which directory a system's ROMs go in, why…
git:20260704.d32e8c6 · audit B · 4 stars
batocera-tuning SKILL.md skill
t3chnaztea/batocera-skills · skills/batocera-tuning/SKILL.md · Use when a Batocera cabinet feels slow, laggy, or stuttery, or when tuning performance: EmulationStation menu/carousel…
git:20260704.7dd30bb · audit A · 4 stars
batocera-yourskill SKILL.md skill
t3chnaztea/batocera-skills · template/SKILL.md · Use when [the specific situations, symptoms, and phrases that should trigger this skill]. Pack the words someone would…
git:20260704.d32e8c6 · audit A · 4 stars

Every file in t3chnaztea/batocera-skills

Browse by kind, by grade A, or by owner.