Seven reference mods, one per modder persona. Each is small enough to read in one sitting, exercises a different slice of the mod API, and is a real, runnable, tested mod — not a snippet.

Copy the one closest to what you want to build.

#	Mod	Persona	Category	What it does
0	`../example_mew_starter`	(legacy)	`GAMEPLAY`	Oak's gift becomes a L20 Mew. The api-1 compatibility proof.
1	`example_balance_tweaks`	Tweaker	`BALANCE`	Faster starters, half-price TMs, a re-slotted Route 1
2	`example_shiny_palette`	Artist	`GRAPHICS`	A teal player recolor derived from your own cache
3	`example_jukebox`	Musician	`AUDIO`	An authored chip song, a new cry, a jukebox screen
4	`example_lost_parcel`	Quest author	`QUEST`	A two-town fetch quest over vanilla NPCs
5	`example_weather`	Mechanic designer	`MECHANIC`	Rain that scales WATER and FIRE damage, behind a ruleset
6	`example_dexnav`	Tool builder	`TOOL`	A START-menu dex overlay with an inter-mod API
7	`example_mini_conversion`	TC team	`TOTAL_CONVERSION`	Sable Cove: one town, three species, one badge

None of these load by default

The engine discovers mods one level below mods/. The gallery lives one level deeper, in mods/examples/, so a fresh install finds none of them and the vanilla game is unchanged — the parity invariant holds by construction.

To run one, copy it up a level:

cp -r mods/examples/example_balance_tweaks mods/
python3 tools/modkit.py validate mods/example_balance_tweaks --base imported

then enable it in options.lua (mods = { example_balance_tweaks = true }) or toggle it in the F10 mod manager.

Coverage

Between them the gallery writes into pokemon, items, encounters, maps, sprites, palettes, icons, music, cries, screens, map_scripts, commands, tokens, statuses, rulesets, constants and field, and exercises:

the write verbs register, override and patch, plus get and each on the merged view
both buses — events:on / events:emit and hooks:wrap — across music.select, battle.damage, ui.start_menu.items, ui.options.rows, battle.started, battle.turn_started, battle.ended, flag.changed, game.ready and assets.transformed
mod.save, mod.options, mod.exports, mod.commands, mod.ui, mod:read, mod.log and mod.path
asset transforms, the trueColor opt-out, script labels and choice, parallel scripts, mod: field routing, replaying an overridden base talk handler through MapScripts.baseTalk, and the no-ROM-content posture

What every entry has

mods/examples/<id>/
  manifest.json     api = 2, a category from the taxonomy, a semver engine range
  main.lua          the entry chunk
  mod.card          sharing metadata: summary, author, tags, differences, credits
  README.md         what it demonstrates, which persona, the commands to try it
  CHANGELOG.md      keep-a-changelog; headings match manifest.version
  tests/            one runnable suite asserting the mod's stated effect
  .modkitignore     keeps the suite out of the distributed package

tests/mod_examples_tests.lua in the engine's own suite loads all seven together and asserts the above, so the gallery cannot rot.

These example mods arent perfect and are just examples to show you basics of wahts possible, but way more than just this is possible.