Name: radio
Author: phareim

Imported from phareim/radio (AGENTS.md). Install upstream with npx skills add phareim/radio. Copyright stays with the author.

AGENTS.md — radio

radio.phareim.no: generative background music you can steer. Pick a landscape, move intensity and a few vibe knobs; the music flows into the change over a few phrases. Thumbs up/down with comments feed a review that Opus does; Opus can also compose new landscapes.

Layout

Part	Where	Docs
Engine (pure TS: theory, composer, conductor, landscapes)	`engine/`	`docs/engine.md`
Audio (Web Audio player, voices, drums, ambience, fx)	`engine/audio/`	`docs/engine.md` (player)
Pixel scenes, one per landscape	`scene/`	`docs/landscapes.md`
Pieces for jam (format, notation, piece conductor, landscape derivation, growing, pattern library)	`engine/piece/`	`docs/piece.md`
Web app (Nuxt 3 Worker, Reader login, proxies to the backend)	repo root	`README.md`
Backend `radio-api` on Sleeper (feedback, compose, review, painting scenes for composed channels)	`backend/`	`backend/README.md`

Rules

jam (~/github/jam, jam.phareim.no) includes this repo as the git submodule radio/ and plays pieces on this engine; radio-api's /jam/* routes are its backend. A change to engine/ or engine/piece/ reaches jam when its submodule moves; keep engine/tsconfig.json so the engine bundles without this app's .nuxt/.
engine/ is erasable-syntax TypeScript with .ts import extensions, so Node runs it natively (the backend validates Opus's landscapes with it) and Vite bundles it. No enums, namespaces or parameter properties.
engine/types.ts is the contract between composer, conductor, player, scene and backend. Change it deliberately and update every side.
Landscapes live in engine/landscapes/<id>.ts; the validator in engine/validate.ts is the schema Opus composes against (the backend pastes it into the compose prompt), so keep its error messages useful.
Bump ENGINE_VERSION in engine/catalog.ts when the composer or conductor changes audibly, so feedback can be read against the version.

Commands

node --no-warnings --test tests/engine.test.ts — engine invariants
node --no-warnings --test tests/piece.test.ts — pieces (jam)
node --no-warnings tests/timeline.ts [bars] — print a scripted session bar by bar
node --no-warnings --test 'backend/test/*.test.mjs' — backend
npm run dev — the app on port 3040 (no login on localhost)
node --no-warnings backend/review.mjs — run an Opus review of new feedback now

Deploy

Push to main: GitHub Actions tests, builds and deploys the Worker radio-web; the Sleeper deploy webhook pulls the repo and restarts radio-api.

Install radio and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "phareim-radio-radio", "kind": "skill", "name": "radio", "description": "radio.phareim.no: generative background music you can steer. Pick a landscape, move intensity and a few vibe knobs; the music flows into the change over a few phrases. Thumbs up/down with comments feed a review that Opus does; Opus can also compose new landscapes.", "publisher": "phareim", "version": "1.0.0", "capabilities": { "domains": [ "coding", "legal" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "radio.phareim.no: generative background music you can steer. Pick a landscape, move intensity and a few vibe knobs; the music flows into the change over a few phrases. Thumbs up/down with comments feed a review that Opus does; Opus can also compose new landscapes." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/phareim/radio", "path": "AGENTS.md", "ref": "3f4695056427bd1c1bb5c3e782b2789cc773e3d2", "url": "https://github.com/phareim/radio/blob/3f4695056427bd1c1bb5c3e782b2789cc773e3d2/AGENTS.md", "key": "phareim/radio/AGENTS.md" } }, "instructions": "# AGENTS.md — radio\n\nradio.phareim.no: generative background music you can steer. Pick a\nlandscape, move intensity and a few vibe knobs; the music flows into the\nchange over a few phrases. Thumbs up/down with comments feed a review that\nOpus does; Opus can also compose new landscapes.\n\n## Layout\n\n| Part | Where | Docs |\n|---|---|---|\n| Engine (pure TS: theory, composer, conductor, landscapes) | `engine/` | `docs/engine.md` |\n| Audio (Web Audio player, voices, drums, ambience, fx) | `engine/audio/` | `docs/engine.md` (player) |\n| Pixel scenes, one per landscape | `scene/` | `docs/landscapes.md`", "cost": { "context_tokens": 658 } }

radio

About

AGENTS.md — radio

Layout

Rules

Commands

Deploy

Install radio and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews