dotfiles

Finds and downloads free, legally available audiobooks — public-domain recordings from LibriVox and the Internet Archive — via curl + jq, no API key needed. Saves into /Volumes/SanDisk/Audiobooks/ (syncs to phone) when mounted, else the current topic folder, and sends the file(s) via the bot MCP `send_document`. Does not touch piracy sites that host copyrighted commercial audiobooks without a license — that's out of scope. Use when: "скачай аудиокнигу", "найди бесплатную аудиокнигу", "скачай книгу в аудио", "где послушать книгу бесплатно", "хочу аудиокнигу", "download an audiobook", "find a free audiobook", "get me the audio version of [book]"

Add, edit, or remove scheduled tasks AND reminders (scheduled Telegram messages) in the dotfiles cron: picks the right file, validates the schedule, wires logging/locking, reinstalls crontab via init-cron-jobs.sh. New private entries go into the dotfiles_private overlay (~/projects/dotfiles_private/cron/cron_jobs/); shareable jobs into public ~/projects/dotfiles/cron/cron_jobs/. Use when: "добавь крон", "запланируй задачу", "поставь в крон", "запиши в крон", "убери из крона", "schedule a task", "add a cron job", "add to crontab", "remove cron job", "напомни мне", "поставь напоминание", "напоминай каждый", "remind me", "set a reminder", "ping me at".

Pick a typeface for a specific job — book, newspaper, infographic, logo, invitation, screen UI, deck — using Julian Hansen's "So You Need A Typeface" decision tree, then ground the pick in what can actually be licensed and shipped: free substitutes, pairing partner, CSS stack, Cyrillic coverage. Use when: "подбери шрифт", "какой шрифт выбрать", "шрифт для логотипа", "шрифт для книги", "шрифт для сайта", "пара шрифтов", "с чем сочетать шрифт", "чем заменить Helvetica", "бесплатный аналог шрифта", "choose a typeface", "what font should I use", "font pairing", "free alternative to <font>", "pick a font for this landing page". Skip for: copying a specific brand's look (popular-web-designs), slide layout and sizes (powerpoint), installing font files, generating specimens.

Run local GGUF models with llama.cpp (CPU/Apple Silicon/CUDA/ROCm), pick the right quant, and discover GGUF repos on the Hugging Face Hub. Use when: "запусти модель локально через llama.cpp", "подбери квант GGUF", "найди GGUF на huggingface", "run a local GGUF model", "which quant should I use", "serve a model with llama-server"

Build a "design board" style collage out of a batch of photos the user just sent: cuts each object out as a transparent PNG, picks a background colour from the room photo, then spawns 10 parallel agents that each design a distinct collage variant using Python + PIL. Sends back a thumbnail grid so the user picks the variant they like, then ships the full-resolution file. Use when user sends 2+ photos in a row and asks any of: "сделай коллаж", "собери коллаж", "сделай мудборд", "несколько вариантов коллажа", "10 вариантов", "сделай дизайн-борд", "make a collage", "build a moodboard", "design board", "несколько коллажей", "разные раскладки". Single-photo edits go to the `image-edit` skill, not here.

Transcribe a Synthesia-style piano YouTube video (falling note bars on a virtual keyboard) into a clean MIDI, a real-grand-piano mp3, engraved sheet music (PDF + editable MusicXML), and a Guitar Pro (.gp5) file. Fuses audio transcription (Spotify basic-pitch) with computer-vision reading of the falling bars for accurate pitches and frame-accurate timing, adds audio-derived velocity dynamics and a sustain-pedal lane, then engraves with key/tempo detection. Use when: "разбери видео пианино в ноты", "пианино в ноты", "пианино в миди", "сделай ноты из видео", "ноты по видео с ютуба", "сделай midi из этого пианино", "видео в ноты", "сделай guitar pro из видео", "synthesia to midi", "piano video to sheet music", "transcribe this piano youtube video", "falling notes to midi", "youtube piano to pdf"

Search and retrieve academic papers from arXiv (and citations via Semantic Scholar) using only curl + Python stdlib. Use when: "найди статью на arxiv", "поищи научные работы", "найди цитирования статьи", "search arxiv", "find papers on", "get citation count"

Generate hand-drawn-style Excalidraw JSON diagrams (architecture, flowcharts, sequence) as .excalidraw files. Use when: "нарисуй диаграмму в excalidraw", "сделай схему архитектуры", "draw an excalidraw diagram", "make a flowchart"

Edit, restyle, relight, cut out, inpaint a region, or generate images. Pipelines: cutout (transparent PNG), edit (new background, relight, compose 2-3 references), inpaint (one masked region), generate (text-to-image). Works on any photo. Use when user sends a photo and asks: "обработай фото", "сделай картинку", "убери фон", "вырежи фон", "сделай прозрачный", "поставь на", "смени фон", "другой свет", "вписать в сцену", "сгенерируй картинку", "нарисуй картинку", "edit photo", "remove background", "cutout", "place on", "relight", "change background", "generate image", "restyle". In a Telegram topic whose CLAUDE.md routes photos here, process every incoming image through this skill.

Animate a single still image into a short video clip (image-to-video) via fal.ai — Kling, Hailuo, Wan. The professional way to bring an avatar, character, or photo to life: real motion (slurping, waving, blinking, hair/steam movement), not slid layers. Outputs MP4; can also produce a looping GIF. Use when user sends or references an image and asks any of: "оживи картинку", "оживи аватарку", "оживи фото", "сделай видео из картинки", "анимируй фото", "пусть двигается", "сделай чтобы он двигался", "сделай гифку из этой картинки", "сделай живую аватарку", "animate this image", "image to video", "make a video from this photo", "make it move", "bring this to life". Not for: editing/generating a still image (use image-edit), or finding an existing reaction GIF on the web (use gif-search).

Geocode places, find nearby POIs, compute routes/distances, and look up timezones via free OpenStreetMap/OSRM data (no API key). Use when: "найди ближайшие кафе", "geocode this address", "сколько ехать от X до Y", "построй маршрут", "find restaurants near", "what timezone is", "directions from A to B"

Extract text, tables, and structure from PDFs and scanned documents using pymupdf (fast) or marker-pdf (OCR/equations). Use when: "извлеки текст из pdf", "распознай скан", "вытащи таблицы из документа", "extract text from pdf", "ocr this scan", "pdf to markdown", "parse this document"

Pull a YouTube video's transcript and reshape it into summaries, chapters, threads, or blog posts. Use when: "перескажи это видео", "сделай конспект youtube", "вытащи субтитры из видео", "summarize this YouTube video", "get the transcript", "turn this video into a blog post"

Comment-driven editing loop for large documents via Google Docs. User drops a file (docx/pdf/md/txt/html) → skill converts it to a native Google Doc and returns the link → user leaves normal Google Docs comments on chunks of text → user says "забирай" → agent reads the comments (with their quoted anchor text), edits the doc in place, replies "done" and resolves each comment. Iterative. Use when: "сделай гуглдок для правок", "давай через комменты в гуглдоке", "залей в гугл док", "забирай комменты", "забери правки из гуглдока", "прикрути гуглдок к этому тексту", "review this in google docs", "pull my google doc comments", "apply the comments", "turn this into a google doc for review". Not for: one-off docx editing without review (use the docx skill); reading a doc the skill did not create (needs a broader Drive scope — see references/setup.md).

Create, launch, and diagnose Android emulators (AVD) on Apple Silicon via the make-avd CLI: optimal RAM/CPU/GPU settings for M1 Max, host-GPU rendering, cold boot, ANR/CPU-starvation troubleshooting. Use when: "создай эмулятор", "сделай AVD", "настрой AVD", "create an emulator", "make an AVD"

Adversarial second opinion for important NON-code decisions and answers. Sends the draft recommendation to an independent free model (litellm `reasoning` rotation group) that is instructed to argue AGAINST it and score it 0-100; the answer is revised over up to 3 rounds and delivered together with the judge's remaining objections — never silent agreement. Use when: "второе мнение", "проверь это решение", "поспорь со мной", "а вдруг я не прав", "devil's advocate", "second opinion", "challenge this decision" — and PROACTIVELY whenever giving advice on a high-stakes personal decision: money (крупная покупка, кредит, инвестиция, переезд), health (лечение, операция — не диагноз), career (смена работы, оффер), legal/visa choices. High-stakes = expensive to reverse. Not for: code review (code-reviewing skill / code-reviewer agent), tech-spec validation (skeptic agent), quick factual questions, low-stakes choices (что приготовить, какой фильм) — там второе мнение только шум.

Generate or edit real Excel (.xlsx) spreadsheets with formatting — colored cells, fills, bold headers, borders, number formats, column widths, multiple sheets, simple formulas. Runs `openpyxl` via `uv`, so nothing is installed globally and it always works even after a cache clean. Saves into the current topic folder and sends via the bot MCP `send_document` tool. Also applies when the user sends an existing .xlsx and asks to change or restyle it. Use when: "сделай эксель", "сделай таблицу в экселе", "эксель с цветами", "excel с раскраской", "сделай xlsx", "покрась ячейки", "сделай .xlsx", "таблица с форматированием", "поправь эксель", "make an excel", "make an xlsx", "excel with colors", "colored cells", "formatted spreadsheet", "edit this xlsx". Prefer this over CSV whenever the user wants colors, formatting, bold headers, multiple sheets, or anything CSV can't carry. CSV is only the fallback when the user explicitly wants a plain, library-free table.

Scaffolds a fresh git repo (usually a proof-of-concept): detects the tech stack, installs the latest-stable linters / formatters / type-checkers, unit + integration tests, git hooks (secret scan + a ≤100-line-per-file gate), a CI workflow, then git init + a verified first commit. Use when: "сделай заготовку репозитория", "подготовь POC", "инициализируй проект", "настрой линтеры и хуки с нуля", "scaffold a repo", "bootstrap a project", "project-init", "set up a new repo with tests and hooks".

Mines Claude Code transcripts for recurring friction and proposes concrete tooling improvements (aliases, CLAUDE.md rules, settings allowlist, serho-platform fixes). Human-gated: nothing is applied without review. The "controlled dream". Use when: "запусти insight-miner", "что улучшить в тулинге", "разбери трение за неделю", "insight-miner review", "mine my transcripts", "what should I improve"

Use when you need information about this project's architecture, tech stack, coding patterns, data model, deployment setup, git workflow, or UX guidelines. Contains comprehensive project documentation including design decisions, technical specifications, and development standards.

Control the Amphetamine.app on macOS via AppleScript / URL scheme: start a wake-lock session (indefinite or N minutes/hours), check if a session is active, end the session. Falls back to built-in `caffeinate` if Amphetamine is not installed. Use when: "включи amphetamine", "запусти амфетамин", "keep mac awake", "останови amphetamine", "выключи амфетамин", "проверь активна ли сессия amphetamine".

Build a durable, composable CLI from API docs, an OpenAPI spec, curl examples, an SDK, a web app, or an existing script — installed on PATH, with stable JSON output, sane auth, and a companion skill so future agent threads can use it. Use when: "сделай CLI", "создай консольную утилиту", "оберни API в команду", "сделай из этого скрипта команду", "make a CLI tool", "build a command-line tool", "wrap this API in a CLI", "turn this script into a command"

Creates site-specific browser-automation skills that drive real websites via Playwright MCP: discovery interview, persistent logged-in profile in ~/.claude-playwright-profiles/<name>, recorded role+name selectors, then a SKILL.md from the proven template (always stops one step before final confirmation / payment). Use when: "сделай скилл для сайта", "автоматизируй сайт", "скилл для браузера", "make a browser skill for site", "automate this website", "site automation skill". Do NOT use for: skills without a website (skill-master), one-off browser tasks (drive Playwright MCP directly), API integrations (curl, no browser).

Execute a deploy: run tests, sync changed files to server, restart services, verify, commit. For user-visible or risk-bearing changes, decouple deploy from release: feature flags, staged rollout (internal → 5% → 25% → 50% → 100%), numeric advance/hold/rollback thresholds, a written rollback plan. Use when: "задеплой", "выкати", "раскатай", "deploy", "ship it", "поэтапный rollout", "staged rollout", "план отката", "rollback plan", "feature flag rollout" Related: deploy-pipeline (CI/CD), pre-deploy-qa, post-deploy-qa, gcp-deploy.

Generate or edit Word (.docx) documents: headings, paragraphs, lists, simple tables, embedded images. Saves into the current topic folder and sends via the bot MCP `send_document` tool. Also applies when the user sends an existing .docx and asks to change, translate, or restyle it. Use when: "сделай реферат", "напиши доклад", "сделай документ", "сделай ворд", "сделай docx", "оформи в ворде", "поправь docx", "напиши эссе", "сделай курсовую", "make a docx", "write a report", "write an essay", "edit this docx".

Tests Claude Code skills end to end: designs scenarios, executes them via parallel subagent runners against a no-skill baseline, grades acceptance criteria on evidence, reports. Modes: quick smoke test (default), design only, run existing scenarios, full A/B cycle. Use when: "протестируй скилл", "smoke test skill" (quick); "придумай тесты для скилла", "design skill test scenarios" (design); "прогони сценарии скилла", "запусти тесты скилла", "run skill test scenarios" (run); "полный тест скилла", "full A/B skill test" (full).

Generate speech audio (WAV/MP3) from text via the user's own free TTS stack: local LiteLLM proxy (localhost:4000) with Gemini TTS, local Piper (Russian), Azure Neural voices. Use when: "озвучь текст", "озвучь это", "сделай аудио из текста", "сгенерируй речь", "сделай mp3 из текста", "проговори текст", "text to speech", "voice this text", "read this aloud", "generate speech". Do NOT use for: Greek audio (greek-tts skill) or speech-to-text (voiceink-local alias / VoiceInk app).

Flight search: cheap dates, specific flights, connections, comparing options. International routes — via Google Flights (CLI `fli`), Russia/CIS — via Aviasales/Travelpayouts (curl). Both paths need no MCP, so the skill works in any topic. Use when (EN): "find flights", "find plane tickets", "how long is the flight", "cheap tickets", "ticket to", "flight to", "when is it cheaper to fly", "flights from X to Y", "round trip", "airfare". Use when (RU): "найди билеты", "найди авиабилеты", "сколько лететь", "дешёвые билеты", "билет до", "перелёт", "когда дешевле лететь", "рейсы из X в Y", "туда-обратно".

Поиск поездов РЖД (Россия), стыковок самолёт + наземный транспорт до городов без аэропорта (Армавир, Кисловодск, Ессентуки, Анапа сезонно) и кавказских транзит-хаков (Кутаиси-автобус-Тбилиси и т.п.). Покрывает расписание, время в пути, цены, сезонность, наземные шорткаты, ссылку на покупку. Use when пользователь упоминает поезд/жд/ржд внутри РФ, или ищет билеты до российского города у которого нет (или закрыт) аэропорт: "поезд из X в Y", "как добраться до Армавира", "Новосибирск Сочи", "Москва Краснодар", "когда поезд", "сколько ехать", "жд расписание", "электричка". Также use для маршрутов через Кавказ (Грузия, Армения): "в Тбилиси", "в Ереван", "из Кипра в Грузию", "дешевле в Тбилиси", "Кутаиси" — там есть хитрые автобусные плечи которые экономят 50-70% цены билета. Также use when MCP поисковики авиабилетов (kiwi, aviasales, flight-search) показали что прямого перелёта нет — нужно достроить наземное плечо до конечного города.

Генерация визуализаций для travel-запросов: сравнение вариантов маршрута, карта поездки, анимация перелёта/поездки. Светлая чистая эстетика. Только полезная инфографика — если визуализация не добавляет инсайта, не рисуй. Use after любого результата поиска авиа/жд билетов из mcp серверов (kiwi, aviasales, flight-search, skiplagged) или из скилла rzd-trains, flights. Выбери ОДНУ визуализацию подходящую под кейс — не штампуй все подряд. Также use когда пользователь явно просит: "покажи маршрут", "сравни варианты", "нарисуй", "визуализируй", "сделай картинку", "сделай гифку", "покажи на карте".

Creates and maintains a personal website for a non-technical user — blog, portfolio, gallery, landing page, or any mix. Content lives as files in the user's topic folder; the site publishes to Surge.sh (accessible from Russia without VPN). Trigger on initialization when the user says, in any language: "I want a website", "make me a site", "let's start a blog", "I want a portfolio", "personal page", "site about [topic]". Trigger on content work — only when the current folder contains `site.yaml`: "new post", "here is text/photos", "for the blog/gallery", "this is my work", "about me", "rename the site", "different color", "delete the post", "publish", "update the site", "show the link", "how does it look now". SKIP when: the folder has no `site.yaml` AND the user is not asking to create a site (e.g. "save this note somewhere"); the user asks how the site works technically (npm, deploy, git) — that is for the operator; the user wants a site for someone else (different topic/stack).

Read and write Airtable bases, tables, and records directly via the REST API and curl — CRUD, filterByFormula, upserts, pagination. Use when: "найди записи в airtable", "добавь строку в airtable", "обнови запись в airtable", "query my airtable base", "add a record to airtable", "update airtable rows"

Create, read, edit, and QA .pptx presentations — slides, speaker notes, templates, layouts — with strong visual design guidance. Use when: "сделай презентацию", "создай слайды", "отредактируй pptx", "вытащи текст из презентации", "create a deck", "make slides", "edit this pptx", "build a pitch deck"

Songwriting craft (structure, rhyme, hooks) and Suno AI music prompts. Use when: "напиши песню", "сочини текст песни", "сделай пародию на песню", "промпт для suno", "write a song", "song lyrics", "suno prompt", "parody song"

Code review methodology and quality standards for comprehensive code analysis. Use to understand WHAT and HOW to review code: 11 review dimensions, process, quality standards. Use when: "проверь код", "code review", "ревью кода", "review this code", "check code quality"

Debug Node.js programmatically from the terminal via --inspect and the Chrome DevTools Protocol. Use when: "отладь node", "поставь брейкпоинт в node", "почему тут undefined в node", "debug node.js", "set a breakpoint in node", "attach a debugger to node"

Debug Python from the terminal with pdb (local/post-mortem) and debugpy (remote DAP, attach to running processes). Use when: "отладь python", "поставь брейкпоинт в python", "отладь падающий тест", "debug python", "set a python breakpoint", "attach a debugger to a running python process"

Create, search, triage, label, assign, comment on, and close GitHub issues via the gh CLI or the REST API. Use when: "создай issue", "заведи задачу на гитхабе", "разбери issues", "повесь лейбл на issue", "create a github issue", "triage issues", "label this issue", "close issue"

Build and maintain a persistent, compounding knowledge base as interlinked markdown files (Karpathy's LLM Wiki pattern): ingest sources, create entity/concept pages, cross-reference, and query. Use when: "заведи вики знаний", "добавь источник в мою вики", "построй базу знаний", "спроси у моей вики", "build a knowledge base wiki", "ingest this into my wiki", "query my wiki"

AI-First development methodology: spec-driven pipeline, project structure, skills/agents ecosystem, quality gates. Use when: "изучи методологию", "изучи глобальную папку", "как работает методология", "how does the methodology work", "explain the workflow" For infrastructure tasks, use infrastructure-setup or deploy-pipeline skills.