volcanicviper

Create a research note from a rough question. Cleans the question, splits into separate files if multiple questions, adds an answer and Google search links. Use when the user has a question they want documented as a note.

Search shell history using atuin. Use when the user mentions searching shell history, finding a past command, or recalling a URL or tool invocation from the terminal.

Reformat a recipe file using consistent style rules. Use when the user wants to clean up or standardize a recipe note in the vault, or create a new recipe note from a URL.

Create a structured Obsidian vault note from a YouTube video transcript — fetches captions with timestamps, cleans the text, divides into sections, adds a TOC and per-section video links, uploads the thumbnail to Imgur, and commits. Use when the user shares a YouTube URL and wants a full transcript note in the vault.

Full grouchygiraffe ingestion workflow — given either a grouchygiraffe media file path or a recipe URL (YouTube, Instagram, or any recipe page), identify the recipe, upload the thumbnail to Imgur where applicable, and write a cleaned recipe note to the vault.

Find digikam notes and digikam setup information. Use when asked to search my digikam, find digikam media, or look up anything about the digikam configuration or database.

Full YouTube video ingestion workflow — given a YouTube URL, fetch the video title, upload the thumbnail to Imgur, create a note in the Obsidian vault with a hero image, and commit it. Use when the user shares a YouTube URL and wants a permanent note in the vault.

Find the correct note to resolve an unresolved ingredient wikilink in a recipe note. Use when an ingredient wikilink like [[leeks]] in a recipe does not resolve to an existing note and you need to find the best matching product note to point it at. Uses islandiguana to enumerate product-tagged candidate notes, then semantically ranks the full list against the link text and its surrounding recipe ingredient line.

Understand the Zephyr sourdough bake tagging scheme. Use when working with Zephyr bake logs, finding which bake log corresponds to a Zephyr key, reading Zephyr voice memo entries to extract bake events, or routing Zephyr entries from any document to their bake logs.

Tag untagged/undated food-related media in the digikam grouchygiraffe and shamblingshark collections. Use when asked to tag untagged food files, run a moonlitlynx food tagging pass, or process the digikam untagged or undated queue.

Download the thumbnail/cover image from a social media post (Instagram, Facebook, or any yt-dlp-supported platform) and upload it to Imgur, returning a permanent URL. Use when the user shares a social media URL and wants a permanent image link.

Given a grouchygiraffe media file path, find the associated YAML, identify the recipe from the thumbnail, locate the author's home base, and return the recipe URL. Use when the user provides a path to a grouchygiraffe .mp4 or .jpg file and wants to know what recipe it is and where to find it.

Use islandiguana to search the Obsidian vault by YAML front matter using yq expressions. Use when asked to find notes by tag, status, or any front matter field, or when asked to peruse or search the Obsidian vault. Obsidian inline #tags are backed by YAML front matter, so islandiguana is the correct tool for finding notes by Obsidian tag.

Clean up raw transcripts from output/ and write to a timestamped file in cleaned/. Use when the user wants to process, clean, or tidy transcript files from the output/ directory.

Annotate a sourdough bake log in Grafana. Use when asked to add Grafana annotations from a Zephyr bake log, build the annotation CLI, or update the bake log grafana section.

Evaluate whether Tom Cucuzza's two-factor bulk fermentation method (dough temperature plus percentage rise) applies cleanly to a given sourdough recipe, and if it does not, which direction the error swings (over- or under-fermentation) and what target to use instead. Use when given a sourdough recipe and asked whether Tom's method, the percentage-rise method, or the two-factor bulk fermentation method applies, or whether following it would over- or under-ferment.

Add a tsconfig.json for TypeScript projects using Vite and/or Chrome extensions. Use when setting up TypeScript in a frontend or Chrome extension project.

Build Chrome extensions with multiple entry points using separate Vite configs per script to avoid code-splitting issues. Use when building a Chrome extension with background, content, and popup scripts.

Create a justfile to orchestrate project tasks. Use when setting up task running for a project.

Set up logging with verbosity levels via --verbose flags, sending log output to stderr. Use when adding logging to a CLI tool or script.

Use pnpm instead of npm for package management. Use when setting up or working on a JavaScript or TypeScript project.

Apply the return early pattern with guard clauses to reduce nesting and improve readability. Use when refactoring conditional logic or writing new functions with precondition checks.

Follow the Unix rule of silence — output nothing on the happy path. Use when designing CLI tools, scripts, or any program that runs unattended.

Write code following SOLID design principles with good information hiding. Use when writing or reviewing code for architecture, class design, or module organization.

Set up Vite and Vitest as the build and test tools, with vite-plugin-checker for TypeScript checking and ESM configuration. Use when starting or configuring a frontend project.

Scaffold a new Python package with pyproject.toml, hatchling build system, ruff linting, and --version support via importlib.metadata. Use when creating a new Python package, Python CLI tool, or Python project from scratch.

View an imgur image by downloading it with curl and reading the local file. Use whenever an i.imgur.com URL is shared, because WebFetch cannot load imgur URLs directly.

Write a brief README with a CLI cheatsheet. Use when creating or writing a README.md file.