debug-and-test

debug-and-test is a skill for Claude Code, Codex from vucinatim/air-jam. It costs 32 tokens per session (581 once invoked), scanned A, original, MIT.

A guide for debugging and testing Air Jam, a project framework, with a defined order for checking logs, diagnostics, and tests.

In plain words
What is it for?
Use it when reading Air Jam logs, adding debug helpers, or deciding what tests to write.
Why use it?
It helps developers investigate problems in the project's architecture without adding unnecessary temporary logging or tests.

Skill for Claude CodeCodex

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

Good fit Use it when reading Air Jam logs, adding debug helpers, or deciding what tests to write.

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

README.md
[![agentmods](https://agentmods.dev/badge/skills/vucinatim/air-jam/debug-and-test.svg)](https://agentmods.dev/skills/vucinatim/air-jam/debug-and-test)
Your own site
<a href="https://agentmods.dev/skills/vucinatim/air-jam/debug-and-test"><img src="https://agentmods.dev/badge/skills/vucinatim/air-jam/debug-and-test.svg" alt="Measured on agentmods" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 581 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.00032 $0.00581
Opus 5 $0.00016 $0.00291
Sonnet 5 $0.00006 $0.00116
Haiku 4.5 $0.00003 $0.00058

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

Security

Grade A, and why

debug-and-test 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 7d 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/debug-and-test/SKILL.md · 73 lines

How it starts

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

Debug And Test

Use this skill when adding debug helpers, using logs, or deciding what to test.

Read First

  1. docs/airjam/debug-and-testing.md
  2. docs/airjam/development-loop.md
  3. docs/airjam/generated/unified-dev-logs.md

Debug Order

  1. inspect the canonical Air Jam dev log stream first
  2. use framework diagnostics second
  3. use domain-level debug helpers third
  4. add custom logs only when they add clear value

Canonical Log Workflow

Use the unified Air Jam log stream early when debugging host/controller/server issues.

Key facts:

  1. the canonical file is .airjam/logs/dev-latest.ndjson
  2. it resets when the Air Jam server process restarts
  3. pnpm exec air-jam-server logs is the preferred path
  4. direct file reads are valid when you need the raw stream
  5. standard dev-runner failures from Vite and similar tools should also appear there as workspace events
  6. this should usually come before adding new temporary logs

Query order:

  1. start with pnpm exec air-jam-server logs --view=signal
  2. use --trace for host-session stories
  3. use --room for one multiplayer room story
  4. use --controller for one player/controller path
  5. use --runtime and --epoch for embedded runtime problems
  6. use --process when the likely failure is in one local dev process such as platform, server, or the active game
  7. use --source when you already know which producer layer you need
  8. fall back to raw NDJSON when signal view is still not enough

Test Order

  1. pure domain logic with unit tests
  2. focused gameplay systems with behavior tests
  3. targeted integration coverage only where the boundary really matters

If the starter testing layout exists, prefer:

  1. tests/game/domain/
  2. tests/game/stores/
  3. tests/game/engine/
  4. tests/game/adapters/
  5. tests/game/ui/

Structure Rules

  1. keep debug helpers under src/game/debug/
  2. keep debug-only code out of hot gameplay paths
  3. prefer structured logs over ad hoc console noise
  4. keep core logic testable without rendering where practical

Read the full file on GitHub · 73 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. 7d ago First seen · 73 lines · 32 tokens per session scan A d3124e6006b9

Subscribe to this mod's changes

debug-and-test is a skill published in the GitHub repository vucinatim/air-jam (6 stars, last pushed 3d ago), licensed MIT. It adds 32 tokens to every session and 581 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

test-electron-app

Drive the real running PostHog Electron app (live tRPC, workspace-server, real data) over CDP with agent-browser. Connect to the running app on port 9222, test desktop changes against a local Django stack, snapshot the accessibility tree, inspect network requests, and screenshot only when explicitly asked. Use when…

PostHog/posthog · 112 tokens

systematic-debugging

4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.

DDS-Solutions/AI-TadPole-OS · 25 tokens

verify-changes

Prove code works by running it, not just checking it exists. Verification through execution rather than inspection. Use after writing or modifying code to ensure it actually functions correctly.

DDS-Solutions/AI-TadPole-OS · 38 tokens

server-side-calls

Call tRPC procedures directly from server code using t.createCallerFactory() and router.createCaller(context) for integration testing, internal server logic, and custom API endpoints. Catch TRPCError and extract HTTP status with getHTTPStatusCodeFromError(). Error handling via onError option.

trpc/trpc · 61 tokens

migrate-oxlint

Guide for migrating a project from ESLint to Oxlint. Use when asked to migrate, convert, or switch a JavaScript/TypeScript project's linter from ESLint to Oxlint.

oxc-project/oxc · 44 tokens

adversarial-reviewer

Adversarial code review that assumes bugs exist and hunts for them. Use when asked to review code, find bugs, audit for correctness, stress-test a PR, or when someone says "tear this apart" or "what's wrong with this". Give no benefit of the doubt — every line is guilty until proven innocent.

emdash-cms/emdash · 71 tokens