dotfiles

End-to-end PR/branch review: principal-engineer pass, hostile adversarial second pass, optional persona lens and Codex outside-view round, decision doc, opt-in inline comments/approve. Use on `/review-code` or 'review this PR/branch'.

Query Buildkite builds, jobs, logs, pipelines, and agents via the bk CLI, and release blocked builds by unblocking their production gate jobs. Use when investigating CI failures, reading build logs, retrying or rebuilding builds, watching build status, or when given Buildkite URLs with 'release these', 'unblock these', 'promote to prod', or 'push to prod'.

Router for me&u work tools. Ship a Linear issue end-to-end (ship-it/auto/autonomous on a Linear URL or ID); create/rewrite agent-ready Linear cards & spikes; query/release Buildkite via bk; query Datadog via pup; orchestrate multi-perspective PR review; generate the daily brief; morning brief triage; regenerate GraphQL schema.gql; fix Redis 6379 "port already allocated" conflicts.

Write and test ast-grep rules for structural (AST) code search — patterns that grep/text search cannot express (e.g. "async functions without error handling", "calls with a specific argument shape", "write an ast-grep rule").

Router for Cloudflare platform work — Workers, Pages, KV/D1/R2, Workers AI/Vectorize, WAF, Wrangler, Agents SDK, Durable Objects, Sandbox SDK, Email. Use for any Cloudflare build/deploy/review; retrieves from CF docs.

Query the codebase knowledge graph for structure — callers, call chains, dependencies, dead code, impact analysis, Cypher/search_graph syntax. Use on `/codebase-memory` or "explore the codebase / who calls this".

Orchestrator-only main thread for coding work: delegate to codex, require separate Claude adversarial review, run a /loop watchdog, handle git/gh plumbing. Use for engineering-manager delegation of coding work.

Manage Nex terminal panes via the nex CLI: split/create/close/move/rename/capture panes, workspaces, groups, layouts, diffs; broadcast to a group; show Codex/Claude status; delegate to live panes with cxd/ccd. Triggers: "split pane", "send to pane/group", "broadcast to <group>", "Codex/Claude pane", "ccd/cxd", "open in Nex".

Router for personal tasks — gym log → Dataview fitness logs; Dad's monthly ANZ money report; monthly Obsidian Area/Projects → Archive; AGENTS.md conformance audit/fix; clean stale Codex desktop state; refine an aichat role prompt; translate to Taiwan Traditional Chinese ("for my mum/dad", 繁體中文, 正體中文).

Audit web performance via Chrome DevTools MCP — Core Web Vitals (LCP/INP/CLS), render-blocking resources, network chains, layout shifts, caching. Use to audit/profile/optimize page load, Lighthouse scores, or site speed.

Generate a pull request description from current-branch changes against main and create the draft PR via gh. Use when asked to create a PR, open a draft PR, or write a PR description.

Maintain one open PR until merge or timeout: rebase onto main, diagnose CI/build failures, push fixes. Use for tend, caretake, babysit, shepherd, monitor, watch, keep alive, or keep green/mergeable.

Implement a Linear issue end-to-end: read the ticket, code, commit, open a PR, monitor CI. Use for do/implement/work on a Linear issue, or when given a Linear URL/ID with intent to implement. Includes an autonomous 'ship' mode that runs to merge without checkpoints (triggered by 'ship', 'ship the ticket', 'autonomously', '--auto').

Rewrite drafts and raw notes into polished non-code communication in the user's voice. Trigger for write/draft/rewrite/summarise/share Slack, email, updates, FYIs, or 'my tone/style/voice'. Skip commits, PRs, technical docs.

Generate a lean daily brief from Slack, Linear, Google Calendar, Google Drive, and the Obsidian vault, then write it to today's journal note (`Area/Journal/YYYY-MM-DD.md`). When today has a retro or a long-gap (monthly-ish) 1:1 (Kim, Tal, Adrian), also write a detailed prep note to `Area/Journal/Daily Prep/` covering everything since the last occurrence. Use when invoked at 3am via cron, or manually as `/daily-brief`, 'run daily brief', or 'regenerate today's brief'.

Generate a conventional commit message from current-branch changes against main and create the commit. Use when asked to commit, write a commit message, or generate a commit.

Create or rewrite Linear issues using the agent-ready card template. Use when asked to create/rewrite a Linear issue, write a spike, post an investigation-finding comment on an issue, or clean up an issue from a URL/ID.

Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, chat applications, voice agents, or browser automation. Covers Agent class, state management, callable RPC, Workflows, durable execution, queues, retries, observability, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing). Use when building email sending (Workers binding or REST API), email routing, Agents SDK email handling, or integrating email into any app (Workers, Node.js, Python, Go, etc.). Also use for email deliverability, SPF/DKIM/DMARC, wrangler email setup, MCP email tools, or when a coding agent needs to send emails. Even for simple requests like "add email to my Worker", this skill has critical config details.

Create and review Cloudflare Durable Objects. Use when building stateful coordination (chat rooms, multiplayer games, booking systems), implementing RPC methods, SQLite storage, alarms, WebSockets, or reviewing DO code for best practices. Covers Workers integration, wrangler config, and testing with Vitest. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Build sandboxed applications for secure code execution. Load when building AI code execution, code interpreters, CI/CD systems, interactive dev environments, or executing untrusted code. Covers Sandbox SDK lifecycle, commands, files, code interpreter, and preview URLs. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Reviews and authors Cloudflare Workers code against production best practices. Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability). Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Triggers on any `wrangler ...` command, edits to wrangler.jsonc/wrangler.toml, or Worker dev/deploy/rollback/secrets/tail tasks. Load before running wrangler commands to ensure correct syntax and best practices. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Renames notes/docs to `yyyy-mm-dd Title.md` and adds reproducibility front matter (summary prompt, conversation archive pointer). Use when normalising filenames, preserving created-at dates, or converting slugs to sentence-case titles.

Create distinctive, production-grade frontend interfaces with high design quality. Use when asked to build web components, pages, or apps; generates polished code that avoids generic AI aesthetics.

Convert files to Markdown with MarkItDown. Use when asked to convert a PDF, Word, PowerPoint, Excel, image, audio, HTML, CSV, JSON, XML, ZIP, or EPUB to markdown, or save a source file as .md.

Create polished branded decks, presentation slides, bento promo slides, and short shareable presentation videos in the me&u engineering visual style. Use when asked to make or modify a branded deck, PowerPoint, Google Slides-inspired presentation, executive/update deck, bento summary slide, Spotify Wrapped/Rewind-style animation, or team-shareable promo asset using the referenced me&u brand colors, typography, frosted tiles, and diagonal-background style.

Generates Obsidian-style implementation guidance docs for technical issues, bug fixes, and features with file refs, code locations, and step-by-step plans. Trigger phrases: 'implementation guidance', 'guidance doc', 'write up how to fix', or turning a Linear issue into an Obsidian implementation doc.

Analyses resumes and interview transcripts, then crafts professional recruiter feedback. Use when reviewing a candidate's resume, writing interview feedback, or drafting hiring decisions.

Router for me&u project work. Use when asked to build branded decks, presentations, bento slides, or Spotify Wrapped-style animations in the me&u engineering visual style; review candidate resumes or interview transcripts and draft hiring feedback; or generate Obsidian-style implementation guidance docs for technical issues, bug fixes, or features.

Fix Redis 'port is already allocated' / port 6379 conflicts for Docker or OrbStack. Use when container startup fails on 6379, when 'docker compose up' reports 'Bind for 0.0.0.0:6379 failed: port is already allocated', or when asked to fix Redis or free port 6379.

Read today's daily brief and walk Paul through items conversationally for triage (file ticket / mark done / defer / draft reply / discuss). Use on 'morning', 'let's triage', 'walk me through today', 'morning triage', or `/morning`. Pairs with the daily-brief skill.

Multi-perspective PR review orchestrator. Runs the review-code skill as a baseline, then fans out 4 specialised perspectives (security, performance, acceptance-criteria, style) in parallel via codex or Claude subagents (user picks at invocation), aggregates findings into a single verdict, and posts inline comments via gh. Use for: multi-perspective review, fan-out review, orchestrated PR review, review with all perspectives.

Query Datadog metrics, logs, monitors, traces, and 30+ API domains via the pup CLI. Use when searching logs, querying metrics, checking monitors, investigating APM traces, or any Datadog API interaction.

Temporarily modifies a Tiltfile in a git worktree so the NestJS app can boot and regenerate schema.gql, then reverts the Tiltfile. Use when the user says to regenerate schema.gql, when schema.gql is stale after @Field decorator changes, when CI's schemaDiff smoke test fails, or when tilt up in a worktree fails with 'local_resource named X already exists'.

Post block-anchored review comments on Notion pages via the Notion MCP. Use when posting RFC/doc review feedback to Notion, anchoring on code blocks or prose, replying to existing discussions, or hitting selection_with_ellipsis validation errors.

Rename epub files to match Paul's personal ebook naming convention. Use when asked to rename, organize, or clean up ebook files (epub or pdf). The convention for naming is: Title - Subtitle. LastName, FirstInitial. Year.ext (omit subtitle if none). No publisher, no hash IDs, no Anna's Archive labels.

Archives monthly Obsidian vault items from Area/ and Projects/ to Archive/ with year-level grouping: combines daily journals into a monthly file, moves discussions, drawings (plus attachments), and project folders, and tucks past-month workouts into subfolders in place. Use when the user says 'archive the vault', 'archive last month', 'monthly archive', 'archive my journal', 'archive workouts', or asks to archive completed monthly work.

Audits current branch changes against local main for AGENTS.md conformance, reports violations inline (written report on request), and auto-fixes them. Use when asked to check agent standards, audit the branch against AGENTS.md, run a conformance check, or enforce project standards.

Cleans stale Codex/ChatGPT desktop state: dead project picker entries, invalid env refs, obsolete worktree pairings. Use when the user says Codex still shows old projects or envs, stale worktrees or PR folders appear in the desktop app, or asks to clean up Codex app state or remove invalid local refs from the Codex or ChatGPT desktop app.