Use when turning a YouTube/podcast transcript into a clean, SEO-tagged blog post with chapters, pull-quotes, and Markdown frontmatter — Whisper transcription plus an LLM cleanup pass that preserves the speaker's voice.

Use when turning a recorded podcast episode into publishable show notes — Whisper transcript with timestamps, chapter summaries, pull-quote tweets, and an SEO-formatted episode page in one pass.

Use when designing distinctive web or mobile UI — a curated bank of 50+ visual styles, 161 color palettes, 57 font pairings, 99 UX heuristics, and 25 chart types, with built-in shadcn/ui MCP integration.

Use when unfamiliar with a section of code and you need the agent to go up a layer of abstraction — produce a map of relevant modules and callers using CONTEXT.md vocabulary, not implementation detail.

Use when moving issues through a small state machine (bug/enhancement × needs-triage / needs-info / ready-for-agent / ready-for-human / wontfix), prepping briefs that AFK agents can pick up cleanly.

Use when synthesising the current conversation and codebase understanding into a PRD published to the issue tracker — no fresh interview, the context you already have IS the input.

Use when breaking a plan, spec, or PRD into independently-grabbable tracker issues — vertical tracer-bullet slices that cut through every layer end-to-end, each one demoable on its own.

Use when building features or fixing bugs test-first — red-green-refactor in vertical tracer-bullet slices, tests verifying behavior through public interfaces so they survive internal refactors.

Use when building throwaway code that answers a single design question — routes to a runnable terminal app (logic/state) or several switchable UI variations (visual) and is deleted once the question is answered.

Use when looking for deepening opportunities — refactors that turn shallow modules into deep ones, informed by CONTEXT.md domain language and prior ADRs. Aim: testability and AI-navigability.

Use when authoring a new agent skill — covers structure, progressive disclosure, when to add scripts, when to split files, and the trigger-rich description format that controls whether your agent picks the skill at all.

Use when adding Husky pre-commit hooks to a repo — installs husky + lint-staged + Prettier, wires `npx lint-staged`, `npm run typecheck`, and `npm run test` into .husky/pre-commit.

Use when bootstrapping a repo so Matt's engineering skills (to-issues, to-prd, triage, diagnose, tdd, etc.) know the issue tracker, triage labels, and domain doc layout — writes AGENTS.md/CLAUDE.md + docs/agents/.

Use when scaffolding course exercise directories (sections, problems, solutions, explainers) that pass `pnpm ai-hero-cli internal lint` — Matt's AI Hero course tooling convention.

Use when refactoring TypeScript TEST files away from `as` type assertions to @total-typescript/shoehorn — fromPartial() for partial type-safe data, fromAny() for intentionally-wrong inputs.

Use when compacting the current Claude Code conversation into a handoff document a fresh agent can pick up — writes to `mktemp -t handoff-XXXXXX.md`, references existing artefacts instead of duplicating them.

Use when you want a relentless grilling session that stress-tests a plan against the project's domain glossary (CONTEXT.md) and prior ADRs, sharpening terminology and updating docs inline as decisions crystallise.

Use when you want the agent to interview you relentlessly about a plan or design — one question at a time, recommended answer included, walking the decision tree until you've reached shared understanding.

Use when you want Claude Code's Bash tool to refuse dangerous git commands (push, reset --hard, clean -f, branch -D, checkout .) via a PreToolUse hook installed in .claude/settings.json or ~/.claude/settings.json.

Use when editing an article draft — split by headings, model content as a DAG of dependencies, confirm the section order with the author, then tighten each section to ≤240 chars per paragraph.

Use when chasing hard bugs or perf regressions — disciplined reproduce→minimise→hypothesise→instrument→fix→regression-test loop, with feedback loop quality treated as the actual skill.

Use when you want the agent to respond in ultra-compressed caveman-speak — a single SKILL.md that drops filler/articles/pleasantries and saves ~75% of output tokens, no plugin or CLI required.

Use when slicing a long video into 3–5 highlight short clips with hook detection, safe-area subtitles, and 9:16 reframing — transcript-driven cuts via Whisper plus FFmpeg encoding.

Use when building a creator portfolio (hero, selected work grid, case-study sections, contact) — opinionated Astro + Tailwind layout that ships in under an hour without dragging in a CMS.

Use when you want Claude Code (or Codex/Gemini/Cursor/30+ agents) to cut ~75% of output tokens by replying in fragment/telegraphic style — full technical accuracy, smaller mouth.

Use when authoring videos as React components — Composition registration, durationInFrames + fps timing, useCurrentFrame, Sequencing, and rendering to MP4 via the Remotion CLI or Remotion Lambda.

Use when adding animations, transitions, gestures, or scroll effects to React/Next.js — Motion (formerly Framer Motion) patterns: motion.div, AnimatePresence, layout/layoutId, springs, variants, whileInView.

Use when researching what people actually said in the last 30 days — pulls posts and engagement from Reddit, X, YouTube, TikTok, HN, Polymarket, GitHub, and the web, then cites every quote inline.

Use when you want Claude Code to route its Anthropic Messages API traffic through a local proxy to free or cheap providers — NVIDIA NIM, Kimi, Wafer, OpenRouter, DeepSeek, LM Studio, llama.cpp, or Ollama.

Use when authoring video compositions as plain HTML and rendering them to MP4 with HyperFrames — agent-first, no React, no build step. CLI: npx hyperframes init / preview / render / lint.

Use when shipping per-post social cards across an entire creator site — Satori-driven JSX-to-SVG-to-PNG pipeline with brand-consistent templates and dynamic per-post variables (title, author, date, tag).

Use when shipping a course or digital-product landing page with email capture, Stripe Checkout, webhook fulfillment, and post-purchase drip emails — end-to-end in one pass with no SaaS subscription.

Use when you want to auto-generate an agent-native Go CLI and MCP server from an API spec, HAR file, or website — with local SQLite mirror, FTS5 search, and compound commands the underlying API can't answer natively.

Use when adding newsletter signup with double opt-in to a creator site — Resend-backed confirmation flow plus a 5-email welcome sequence triggered on confirmation, no third-party form widget.

Use when scripting → AI voice → matched-timing video — ElevenLabs/PlayHT TTS aligned to HyperFrames or Remotion captions for screencast and tutorial-style videos at scale.

Use when you want a 72-hour viral radar across Reddit, X, TikTok, Instagram, HN, YouTube, and GitHub — clickable HTML mirror plus an optional editorial leaderboard rendered in Paper.design.

Use when you want to turn any blob — Markdown, JSON, plain text, or a doc URL — into a single self-contained editorial HTML page with clickable links, content-aware styling, and no external deps beyond Google Fonts.

Use when localising a creator video into multiple languages — Whisper transcription, LLM translation, voice cloning per language, alignment to original timing, and burned-in subtitles in one pipeline.

Use when building a self-owned alternative to Linktree — single-page minimal link list with analytics, theming, scheduled-link toggles, and zero monthly fees, deployed under your own domain.

Use when expanding one long-form video or essay into a multi-platform pack — Twitter thread, LinkedIn post, Reels/Shorts script, newsletter blurb — preserving voice and key beats from the source transcript.

Use when starting a creator brand from a moodboard or reference site — extract colors, type pairings, spacing tokens into a single JSON token file consumable by Tailwind v4 / CSS custom properties / Figma.

Use when building luxury landing pages with Kling image-to-video AI, GPT Image stills, pinned 'stop scroll' scenes, and scroll-driven frame sequences. Requires FAL_KEY env var (fal.ai) — ask user before any call.