host-surface

host-surface is a skill for Claude Code, Codex from vucinatim/air-jam. It costs 37 tokens per session (515 once invoked), scanned A, original, MIT.

A guide for building the Air Jam host shell, the surrounding screen that contains the active game, room controls, and overlays.

In plain words
What is it for?
Use it to structure the game viewport, room setup, lobby or join shell, overlays, host controls, and related modules.
Why use it?
It keeps the game surface full-screen and prevents host interface elements from disrupting gameplay layout.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to structure the game viewport, room setup, lobby or join shell, overlays, host controls, and related modules.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/vucinatim/air-jam/host-surface
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.

Any agent
npx skills add vucinatim/air-jam --skill host-surface
Clone the repo
git clone --depth 1 https://github.com/vucinatim/air-jam

Made for: Claude Code, Codex.

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 host-surface

README.md
[![agentmods](https://agentmods.dev/badge/skills/vucinatim/air-jam/host-surface.svg)](https://agentmods.dev/skills/vucinatim/air-jam/host-surface)
Your own site
<a href="https://agentmods.dev/skills/vucinatim/air-jam/host-surface"><img src="https://agentmods.dev/badge/skills/vucinatim/air-jam/host-surface.svg" alt="Measured on agentmods" height="20"></a>
Per session 37 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 515 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.00037 $0.00515
Opus 5 $0.00018 $0.00258
Sonnet 5 $0.00007 $0.00103
Haiku 4.5 $0.00004 $0.00052

Measured 8d ago against content hash 584db5584cd5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

host-surface 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 8d 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.

packages/cli/template-assets/bootstrap/skills/host-surface/SKILL.md · 53 lines

How it starts

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

Host Surface

Use this skill for host presentation, overlays, room chrome, and game viewport composition.

Read First

  1. docs/airjam/generated/host-system.md
  2. docs/airjam/generated/project-structure.md
  3. docs/airjam/visual-system.md if the template already ships a shared visual language
  4. docs/airjam/generated/controller-ui.md only if the host and controller should mirror a shared visual language
  5. docs/airjam/composition-shell-contract.md when the host lobby/join shell is part of the work

Surface Rules

  1. the active game surface should fill an absolute inset-0 root
  2. avoid wrappers that constrain, crop, or offset the play surface accidentally
  3. keep host chrome outside the gameplay coordinate space where possible
  4. keep overlays layered above the game surface, not embedded into gameplay components

Composition Rules

  1. separate room bootstrap, shell, gameplay viewport, and overlays into distinct modules
  2. keep host-only orchestration in src/host/
  3. keep gameplay state and rendering concerns in src/game/
  4. prefer reusable overlay modules over inline one-off markup

Layout Rules

  1. avoid overflow bugs on the main host surface
  2. prefer fluid sizing over fixed panel widths and heights
  3. keep QR, room, pause, and status UI visually secondary to the active game
  4. keep readable safe margins for overlays without shrinking the gameplay surface unnecessarily

Lobby Contract Rule

For host lobby work:

  1. the host lobby should expose room context, QR access, join URL field, copy/open actions, and a primary start action
  2. prefer useHostJoinControls plus JoinQrOverlay, JoinUrlField, JoinUrlActionButtons, JoinUrlControls, and LifecycleActionGroup unless the game needs a fully custom shell
  3. if the shell is fully custom, preserve the same join and lifecycle behavior contract

Anti-Patterns

  1. gameplay rendered inside a card, panel, or centered content column
  2. host shell state mixed directly into gameplay components
  3. overlay UI positioned by guesswork inside the game scene
  4. host layout choices that make the game viewport smaller than necessary

Read the full file on GitHub · 53 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. 8d ago First seen · 53 lines · 37 tokens per session scan A 584db5584cd5

Subscribe to this mod's changes

host-surface is a skill published in the GitHub repository vucinatim/air-jam (6 stars, last pushed today), licensed MIT. It adds 37 tokens to every session and 515 once invoked, about $0.0002 per session on Opus 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-08-31.

Related

Other skills, from other repositories

magic-ui

Use this skill when users want to add, customize, or troubleshoot Magic UI components in React/Next.js projects. It covers component selection, shadcn registry installation (@magicui/), integration patterns, and practical quality checks for accessibility and maintainability.

magicuidesign/magicui · 56 tokens

building-canvases

Create or edit a PostHog freeform canvas — a sandboxed browser application (data board, document, form, small tool, graphics experiment) stored in PostHog and rendered by the desktop/web app. Use when a task asks to build, generate, update, or fix a standalone canvas app, or when a freeform canvas id is given as the…

PostHog/posthog · 148 tokens

composing-grid-canvases

Compose PostHog grid canvases — widget grids (including the user's home canvas) built from reusable component canvases. Use when a task asks to add, fill, move, resize, or remove a widget on a grid or home canvas, to compose a whole canvas of widgets from one ask, to build a reusable widget/component, or when a…

PostHog/posthog · 136 tokens

quill-code

Edit the @posthog/quill design system locally and consume the change in products/desktop before it is published to npm. Use when changing quill components/primitives/tokens, when a quill change must be tested inside the Code app, or when the user mentions quill, the design system, the .local-quill tarball, or the…

PostHog/posthog · 84 tokens

biome-creation

A workflow for placing rocks, trees, plants, and other reusable scene objects into a Unity biome, a themed area of a game world. It also covers regenerating the biome and checking the result with screenshots.

moorestech/moorestech · 170 tokens

before-after-audit

A before-and-after screenshot workflow for checking visual changes in a Unity scene. It keeps the Scene view camera fixed, compares the two images, and sends the difference for an external review.

moorestech/moorestech · 81 tokens