Earbrief — Development skill for Claude Code

earbrief

Your personal audio briefing, generated on-demand by AI. No servers, no app, no code to run — the whole system is this repo plus GitHub Pages: you ask your AI assistant to generate episodes when you want them, it writes and publishes them, and a GitHub Pages site plays them in your browser with text-to-speech. Git is the only database.

• Fronts: N independent topic areas — IT, politics, sports, whatever you follow — each with its own sources, curriculum, and episodes.
• On-demand news digests: run /digest when your backlog is empty and the AI researches and writes spoken news episodes from each front's sources.
• On-demand deep-dives (~20 min): run /deepdive and the AI writes a lesson from the next curriculum item, rotating across fronts.
• Article episodes: run /article to turn any article into an explained audio episode.
• Player: one GitHub Pages URL bookmarked on your phone — switch fronts with a tap, play/pause, progress, listened tracking, optional Spanish rendition.

The template ships with one AI/ML engineering front as a worked example; your fronts, sources, and curricula are yours to define — any fields work.

Requirements

• An AI coding assistant (OpenCode, Claude, Cursor, etc.) for interactive repo management and content generation.
• A GitHub account.
• GitHub Pages enabled on your repository.

Quickstart

1. Click Use this template → create your own repo (can be public or private).
2. Clone it, open a terminal in it, run your AI coding assistant (e.g., opencode).
3. Type /setup. The agent interviews you (language, listener profile, topic domains), personalizes the sources and curriculum, sets up GitHub Pages.
4. Enable GitHub Pages in your repo settings (Settings → Pages → Source: GitHub Actions).
5. Bookmark the GitHub Pages URL.
6. When you want new content, type /digest (news) or /deepdive (learning episode).

Commands & use cases

Everything is driven from an AI agent session in you