dotfiles

Run a bounded review-remediate loop in which every review round uses the external Codex CLI through the codex-review workflow. Use when asked to have Codex iteratively review and fix uncommitted changes, a branch or commit diff, a pull-request diff, named paths, or another explicit target until no verified finding remains or a safe round limit or blocker is reached.

Run a bounded, evidence-driven review and remediation loop over uncommitted changes, a base-branch merge diff, commits, pull-request diffs, or an explicit custom target. Use when asked to review code iteratively, fix verified findings within the original authorization, repeat review until clean or safely bounded, or provide a final review audit without external reviewers or remote writes.

After finishing the current task, run an external Codex CLI review, return its feedback verbatim, and add your own independent assessment of the findings. Use when the user says "Codex review", "ask Codex to review", or runs /codex-review. Codex is a second opinion — not ground truth.

Compare the current agent's prior user-visible analysis report with one explicitly supplied report file and produce a concise numbered decision table covering material conflicts, useful improvements, and questions needing user judgment. Independently recommend how to resolve conflicts. Use only when the user explicitly invokes this skill with exactly one target report file; never invoke implicitly, from a general comparison request, or without that file.

Compare the current Git worktree with one explicitly supplied peer worktree and identify only material improvements to apply to the current worktree. Use only when the user explicitly invokes this skill with exactly one target worktree path; never invoke implicitly, from a general comparison request, or without that path.

Upgrade all project dependencies across Mix/Hex, npm applications including Phoenix assets and browser extensions, and Tailwind. Use when asked to update, upgrade, or modernize every dependency and repair resulting code, configuration, or test breakage.

Perform one deliberate final pass over completed changes to catch material omissions or inconsistencies before handing off. Use at the end of implementation and verification, especially when code, documentation, tests, or configuration must remain coherent.

Run a bounded, evidence-driven second-opinion code review with the local Grok CLI while the primary agent remains responsible for implementation and verification. Use whenever the user explicitly says "Grok review" or "Grok review skill". Use implicitly only when a change is both genuinely complex across multiple codebase areas and materially high-risk or high-coupling for correctness, regressions, security, or performance. Never infer use from size or file count, and never trigger implicitly for simple or localized changes.

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, latest/current/default-model prompting guidance, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing to official OpenAI domains.

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

Carefully merge the `upstream` branch into `main`: prioritize the current project's existing behavior in locally customized code while otherwise preserving upstream changes as fully as practical. Use when synchronizing main with upstream or handling conflicts from that merge.