unbanished: Skill for Claude Code

.claude/skills/banished-video/SKILL.md

banished-video is a skill for Claude Code from tanepiper/unbanished. It costs 90 tokens per session (2,441 once invoked), scanned A, original, Apache-2.0.

A procedure for recording short videos of the Un-Banished game without opening a normal game window. It captures frames, joins them with FFmpeg, and checks the result before it is reported.

In plain words
What is it for?
Making videos of animations, walking citizens, camera movement, weather, and seasons for documentation or testing.
Why use it?
It provides a repeatable way to show or inspect game motion while keeping temporary frames and saves in a separate scratch location.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions AGENTS.md.

This is tanepiper/unbanished's own configuration. It tells Claude Code how to work on unbanished itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything unbanished configures →

Reuse

Borrowing it

Nothing to install: this file belongs to tanepiper/unbanished. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/tanepiper/unbanished/main/.claude/skills/banished-video/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/tanepiper/unbanished

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 banished-video

README.md
[![agentmods](https://agentmods.dev/badge/skills/tanepiper/unbanished/banished-video/github.svg)](https://agentmods.dev/skills/tanepiper/unbanished/banished-video)
Your own site
<a href="https://agentmods.dev/skills/tanepiper/unbanished/banished-video"><img src="https://agentmods.dev/badge/skills/tanepiper/unbanished/banished-video/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 banished-video

Your own site · 80×15
<a href="https://agentmods.dev/skills/tanepiper/unbanished/banished-video"><img src="https://agentmods.dev/badge/skills/tanepiper/unbanished/banished-video.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 90 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,441 The whole file, excluding the scripts and references it only reads on demand.
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.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00090 $0.02441
Opus 5.5 $0.00036 $0.00976
Sonnet 5.5 $0.00018 $0.00488
Haiku 4.5 $0.00009 $0.00244

Measured 3d ago against content hash 0665e29f2c30, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

banished-video 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 3d ago.

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/skills/banished-video/SKILL.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Record a video headlessly

A video is a sequence of frames. The game can already save frames: the screenshot script command writes Screenshots/Screenshot<N>.bmp in the user folder, with N counting up from 0. So queue one screenshot command per video frame in a --boot-capture run, then join the BMPs with FFmpeg. No Rust change is needed. The person-readable guide is docs/develop/VIDEOS.md; tools/videos.sh makes the documentation's videos and is the worked example.

Rules

  • Always set UNBANISHED_USER_DIR and UNBANISHED_SETTINGS to a scratch folder (the frames and any save go there; the player's own folders are never touched).
  • Frames go to scratch or game-data/derived/ while you work. Only the finished, small WebM of Un-Banished's own frames may be committed, in docs/assets/videos/ (AGENTS.md rule 1); never commit the BMP/PNG frames or footage of the original game.
  • Look at the result before you report it: extract a few frames into one contact sheet and open it with Read (see "Check" below).

Steps

  1. Find the shot. Make single --boot-capture PNGs first (cheap: ~5 s for a 20 s run) and open them. Typical set-up for a town:
    export UNBANISHED_USER_DIR=$W/user UNBANISHED_SETTINGS=$W/settings.txt
    unbanished --boot-capture $W/shot.png 30 --capture-size 1280x720 \
      --script "load save-game/[email protected]" \
      --click-at 1060,470@14 --press [email protected] --press [email protected] \
      --wheel 8@16 --wheel [email protected] ...            # 28 wheel events reach the closest zoom
    
    • The wheel zooms towards the screen centre, not the pointer. To move the camera, click a building (--click-at X,Y@T), press its window's buttonCenter, then buttonClose.
    • Camera moves: --hold ACTION@START-END holds a key-map action's key (RotateLeft, RotateRight, Forward, Back, Left, Right, ZoomIn, ZoomOut, PitchUp, PitchDown); a short PitchUp (~0.5 s) lowers the camera to the horizon. --move 0,360@T (a screen edge) scrolls until a --move back to the middle. Edge scrolling and the movement keys travel faster when zoomed out, so zoom in for slow moves.
    • Follow a citizen: --script "select citizen N@T" (or select profession fish N), then --press buttonFollow@T+0.5.
    • tools/videos.sh modes are worked examples: orbit, big-town, river, fishing (held keys), follow-citizen, montage (edge scrolling, seven shots joined with xfade).
    • Cinematic camera (drawing only; the game camera, simulation and saves are unchanged): --camera "EX,EY,EZ>TX,TY,TZ@T" keyframes (several: a smooth curve, eased at the ends; map cells from the map's middle, z up, water at 0); --camera-follow "SUBJECT@START[-END]" with citizen N, profession fish N, boat N, animal deer N; --camera-rig BACK,UP,SIDE,AHEAD,LOOK_UP (default 4,2.6,0.8,8,1, over a citizen's shoulder), --camera-fov 50, --camera-smooth 0.6. A follow keeps buildings, trees and bridges out of the line of sight (picking meshes; it moves in closer, else rises up to 8; --camera-clear 0 turns it off). Find coordinates with RUST_LOG=info,unbanished::view::cinematic=debug and a follow: it logs the subject's position each step (a boat's track is the river). Modes boat-shoulder, fisher-closeup, river-flight (for Save 47) and farmer, labourer, vendor (Save83, the follow helper: speed 2, rig 3.5,2.6,0.8,3,1.2) in tools/videos.sh are the examples; each writes a NAME-poster.webp too (poster FRAME NAME). This camera does not depend on drawn frames, so the "draw every frame" rule below does not apply to it.
    • Quality: every town video in tools/videos.sh uses --capture-size 1920x1080 and the HQ settings (town() adds them, and scales CLICK, --move and --click-at from 1280x720 positions with px; crops are relative, $middle/$top). Each video gets a NAME-poster.webp (poster FRAME NAME). The montage reuses the run_* functions and keeps parts with clip NAME START COUNT, joined by xfade transitions listed in joins. The settings are --setting VideoMultisample=3, VideoTextureFilter=16, VideoShadowScalar=0, VideoShaderDetail=3, VideoReflectionDetail=2; frames are scaled to 768x432 with lanczos. Pass the settings as separate arguments (zsh does not split $HQ; the log line antialiasing: 4 samples confirms them). FILTER=sepia|grey|psychedelic colours the encode.
    • Titles: the montage has an opening title, a caption per shot (captions) and a closing card, drawn with FFmpeg drawtext (the text TEXT FONT SIZE X Y FROM TO helper; Georgia). Homebrew's default ffmpeg lacks drawtext; the script prefers ffmpeg-full (/opt/homebrew/opt/ffmpeg-full/bin/ffmpeg, installed) or FFMPEG. TITLES=0 turns them off. MONTAGE_CLIPS=DIR keeps the shots, so re-titling takes seconds, not 10 minutes.
    • --script "speed 10@T" for time-lapses; --script "open Template/UtilityMap.rsc@T" for windows; UNBANISHED_SEED=N with --press [email protected] --press [email protected] for a new game.
  2. Queue the frames. One --script "screenshot@T" per frame (screenshot ui@T keeps the interface). Two rules make the timing exact:
    • put each time half a frame after the frame time, T = start + i/30 + 1/60: the capture loop steps 1/30 s in f32, and a command exactly on a frame boundary can land on the same frame as its neighbour (one run gave 137 files for 180 commands);
    • draw every frame from before the camera moves (start the screenshots at the first click or wheel, and drop the early frames when encoding). A headless run draws only when something asks for a frame. The camera's easing depends on the drawn frames: a camera that was not drawn for seconds jumps, then drifts. For a time-lapse, use a longer step instead of 1/30 (seasons: 0.75 s at speed 10).
  3. Encode (VP9 needs yuv420p; the BMPs are RGB):
    ffmpeg -framerate 30 -start_number 360 -i $W/user/Screenshots/Screenshot%d.bmp -frames:v 240 \
      -vf "crop=960:540:160:90,format=yuv420p" -c:v libvpx-vp9 -b:v 0 -crf 36 -row-mt 1 -an out.webm
    
    Keep documentation videos small: 384–1280 px wide, 2–12 s, under ~1.5 MB each. tools/videos.sh chooses each film's crf itself (its vp9 function): the largest crf whose VMAF reaches 93 (VMAF_TARGET), within the film's size limit. Use it, or its vp9 function's method, rather than a fixed crf. When measuring VMAF by hand, renumber the frames on both inputs (settb=1/30,setpts=N), or WebM's millisecond times mis-pair them. Cropping the middle of a 1280x720 capture makes citizens larger than zooming can.
  4. Animations of one model come from the viewer, not the game: one --capture run per frame with VIEWER_POSE=CLIP@SECONDS VIEWER_ANIMS=GROUP (filters match the backslash entry name, e.g. 'Animals\Chicken\ChickenMesh'). ~0.35 s per frame.

Read the full file on GitHub · 124 lines

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. 3d ago First seen · 124 lines · 90 tokens per session scan A 0665e29f2c30

Subscribe to this mod's changes

banished-video is a skill published in the GitHub repository tanepiper/unbanished (23 stars, last pushed 22d ago), licensed Apache-2.0. It adds 90 tokens to every session and 2,441 once invoked, about $0.0004 per session on Opus 5.5. 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-11-15.

Related

banished-video compared with skills from other repositories

banished-video next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
banished-videotanepiper/unbanishedSkill2322d agoApache-2.0A90Claude Code
soundclawiamlukethedev/Claw3DSkill2.5k14d agoMITA18Claude Code, Codex
task-manageriamlukethedev/Claw3DSkill2.5k14d agoMITA56Claude Code, Codex
todoiamlukethedev/Claw3DSkill2.5k14d agoMITA12Claude Code, Codex
gamedev-shippingericrisco/rsc-harnessSkill636todayMITA99Claude Code, Codex
self-evolvetettethu/VibeGameSkill38810d agoApache-2.0A50Claude Code, Codex
artist-self-evolvetettethu/VibeGameSkill38810d agoApache-2.0A62Claude Code, Codex