Vis Classic Guide

SkillMedia

Comprehensive implementation and profile reference for NullPlayer's vis_classic mode (CVisClassicCore, VisClassicBridge, SpectrumAnalyzerView integration, menu/keyboard controls, transparent-background behavior, persistence keys, and bundled INI profiles). Use when modifying vis_classic rendering behavior, profile import/export, assigning profiles to skins, or debugging profile-specific response differences.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Vis Classic Guide skill

What this skill tells your AI

The instructions your AI receives, as published by ad-repo/nullplayer in skills/vis-classic-guide/SKILL.md and read by ahel’s review.

Overview

Use this skill when working on vis_classic in NullPlayer.

This skill documents:

  • Full implementation architecture (audio input to CPU frame generation to Metal presentation)
  • Menu, keyboard, notification, and persistence behavior for profile operations
  • Every bundled vis_classic profile with technical parameters and human description

Workflow

  1. Read references/implementation.md before changing vis_classic behavior.
  2. Read references/profile-catalog.md when selecting, comparing, or assigning profiles.
  3. If profiles change, regenerate the catalog:
    • python3 skills/vis-classic-guide/scripts/generate_profile_catalog.py
  4. Validate skill metadata after edits:
    • python3 /Users/ad/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/vis-classic-guide

Skin Assignment Guidance

When planning skin-specific profile defaults:

  • Keep window scope separate (mainWindow vs spectrumWindow), matching existing vis_classic persistence behavior.
  • Treat profile selection as runtime state (not compile-time skin metadata) unless you are explicitly extending skin config schema.
  • Prefer deterministic identifiers for skins (bundle skin name/path hash) if adding a profile-per-skin map.

References

Scripts

  • scripts/generate_profile_catalog.py: Rebuilds the profile catalog directly from bundled .ini files.

Signals

GitHub stars
120
Forks
9
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
vis-classic-guide
Source
github.com/ad-repo/nullplayer