dotfiles

Create a friendly, self-contained webpage that teaches a difficult idea in very simple language using concrete analogies, small visual steps, and playful interaction. Use when the user asks for an ELI5 explanation, says "explain it like I'm five," wants a topic taught visually in a webpage, or needs a beginner-friendly interactive explainer for technical, scientific, financial, or abstract material.

Open and operate the user's keyboard-first Apple Mail triage desk with persistent progress and concurrent agent workers. Use when the user says mailbox, wants to review or process email one-by-one, asks to resume inbox triage, wants a local webpage for deciding what to do with messages, or wants agents to handle email instructions while they continue reviewing.

Use when drafting or sending a reply in an existing chat thread, especially WhatsApp, SMS, email, or DM. Ensures the message continues the current conversation naturally by reading recent context, matching tone, and avoiding unnecessary greetings or restarts.

Manage the user's coding workspaces, threads, worktrees, tabs, panes, and running AI agents through Herdr. Use whenever the user says thread, threads, workspace, worktree, tab, pane, agent, switch, focus, open a workspace, create a worktree, start an agent, send input to an agent, check what is running/waiting, or asks to migrate old tmux thread workflows. Prefer this over tmux unless the user explicitly asks for tmux.

Legacy tmux-only thread picker. Use only when the user explicitly asks for tmux or the old tmux-thread-picker CLI. For normal thread, workspace, worktree, pane, or agent management, prefer the Herdr workspace manager skill.

Draft and send WhatsApp messages to Jules from the user's macOS WhatsApp Desktop. Use when the user asks to message, notify, update, or send something to Jules on WhatsApp, especially for BabaCoiffure incident summaries; always draft the message first, apply the user's wording feedback, and send only after explicit confirmation.

Stage changes, generate a conventional commit message, and create the commit.

Sparring Tech Lead / CTO coaching and controlled execution mode for real engineering issues. Use immediately when the user says "sparring" to coach iteratively in read-only mode. Use "execute patch" only when the user explicitly asks to move from coaching/review into implementation. Coach and execute with strong safeguards around architecture, domain modeling, robustness, APIs, tests, observability, security, delivery, migration, code changes, commits, pushes, CI, and technical leadership.

Manage Sentry issues as an engineering triage loop: inspect Sentry projects, classify production errors, decide whether to ignore, resolve, route to humans, or create linked tracker tickets, and keep Sentry state aligned with fixes. Use when the user asks to triage, clean up, prioritize, route, or manage Sentry issues, error groups, releases, regressions, or alert noise.

Pick up Linear backlog issues marked agent:ready, implement the requested code change, verify it, update the Linear issue state/comments, push a branch, and open a GitHub draft pull request. Use when the user asks Codex to work the agent-ready queue, take the next agent:ready ticket, implement Linear work, or create draft PRs from ready backlog items.

Creates a beautiful HTML explanation of a repo, spec, PR, architecture, or concept so a smart beginner can understand and retell it. Use when the user asks to visualize, diagram, or explain something as an HTML artifact.

Manage an engineering backlog for humans and AI agents: review the whole loop, classify issues, improve issue quality, sync pull-request state, and label safe tickets so AI agents know what work they can pick up. Use when GitHub Issues, GitHub Projects, Linear, or an explicit local backlog path is the source of truth.

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

Run a two-pass GitHub pull request review and fix workflow. Use when the user asks Codex to review a PR with a subagent, then have the main agent review it too, implement required changes, push them, and reply to PR review comments or threads.

Create diagram artifacts in /tmp by default. Use when the user asks Codex to make, draw, visualize, map, or explain with a diagram, flowchart, architecture diagram, sequence diagram, state machine, process flow, dependency graph, or HTML/SVG/Mermaid visual, especially when they ask for a standalone page or artifact.

Read local macOS WhatsApp chats and summarize user requests, including voice-note transcription. Use when the user asks Codex to inspect a WhatsApp conversation, find what someone said, understand a cancellation/request, search recent WhatsApp messages, or transcribe WhatsApp audio/voice notes from the local WhatsApp database/media folder.

Find, inspect, and safely verify the BabaCoiffure production MongoDB connection from the user's local Neovim dadbod config and shell environment. Use when the user asks for the production database, prod DB connection, MongoDB Atlas access, dadbod database config, or to verify read-only production DB connectivity for BabaCoiffure.

Capture coding-agent behavior as structured review cases. Use when the user asks to save, archive, log, document, transcript, review later, standardize, or learn from an agent session, including the original prompt, visible conversation transcript, attempted work, final solution, failures, bugs, commands, tests, and follow-up lessons.

Work with Apple Calendar on macOS from Codex: inspect, add, update, import, deduplicate, and delete local/iCloud calendar events using EventKit, AppleScript, .ics files, or Computer Use. Use when the user asks to put dates in their calendar, modify event times, remove duplicates/all-day events, troubleshoot Calendar permissions, or recover from Calendar automation failures.

Manage and improve the user's Apple Mail organization safely. Use when the user asks to organize Apple Mail, add or run Mail rules, classify senders, separate pro/perso mail, create dashboards or smart mailboxes, tune invoice/admin/newsletter routing, audit connected mail accounts, or make the mailbox workflow increasingly automatic without deleting mail.

Make an elegant solution to the problem we are addressing.

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications.

Review branch or PR changes for bugs, regressions, security issues, and missing tests. Use when the user asks for a code review or comparison against main.

Write safe, targeted data into the BabaCoiffure local MongoDB for manual testing. Use when the user asks to seed, insert, backfill, or modify local DB records, especially users, chats, appointments, or fixture data in the BabaCoiffure monorepo local development database.

Turn calendar event feedback into concrete Obsidian note updates. Use when a user asks to inspect a calendar lesson, extract the feedback or notes from the event, and apply that feedback to a matching planning note or learning resource.

Use Obsidian from terminal for vault workflows and Neovim note navigation. Use when the user asks to open, create, search, or link Obsidian markdown notes from shell, or to run `obsidian://` URI actions.

Manage Apple Reminders from Codex. Use when the user asks to create, update, complete, delete, or list reminders/tasks in Apple Reminders on this Mac, including "remind me", "make a reminder", "due today", or "show my reminders".

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".