skills

Do not use unless the user explicitly requests it. Dispatch each requested task to a new Codex session in a newly allocated dedicated worktree, then coordinate rebasing and fast-forward integration into local main without implementing, reviewing, or archiving the task in the coordinator session.

Use only when explicitly requested by the user or, during an explicit debugging session, after other relevant checks such as typecheck, lint, and tests have been exhausted.

Use only when the user explicitly requests this skill.

Use when building greenfield React SPA UI with Lisse (`@lisse/react` or `@lisse/core`) for Figma-style smooth/squircle corners, choosing `SmoothCorners` vs `useSmoothCorners`, configuring corner smoothing, borders, gradient borders, shadows, styling hooks, auto-effects, client-side path generation, performance, or limitations.

Use React Aria and React Stately hooks to build accessible custom React components, including choosing the right hook, wiring refs/state/props, preserving ARIA and keyboard behavior, excluding React Aria i18n and SSR utilities, and checking hook-specific guidance in bundled category docs.

Design, review, and optimize PostgreSQL and SQLite schemas, queries, migrations, transactions, indexes, and data-access code, especially when SQL should remain portable between both engines.

Use when building React animations with Motion primitives, including motion components, animation props, gestures, layout/scroll/SVG animation, transitions, variants, Motion values, core React Motion hooks/components, and occasional vanilla JavaScript Motion APIs when React APIs are less appropriate or less capable.

Use Fallow as scoped TypeScript/JavaScript codebase evidence after nontrivial JS/TS edits, before deleting exports/files/dependencies, or when considering Fallow cleanup fixes. Run audit and dead-code trace commands, read JSON output, and act only on findings introduced by or clearly related to the current task.

Build, review, debug, or explain greenfield Vercel AI SDK v7 code, including Node/ESM setup, instructions prompts, streaming, tool context, telemetry, UI messages, multi-step results, MCP transport, Vue, and OpenAI/Anthropic/Google provider behavior.

Use whenever writing, reviewing, debugging, or explaining Zod code. Focus on Zod v4 APIs, defaults, and feature differences; this is not a v3-to-v4 migration playbook.

Explain, use, or review Drizzle ORM v1 RC behavior when model knowledge may be stale, especially differences from Drizzle v0 around Relational Queries v2, defineRelations, object filters, drizzle-kit migrations, casing, validators, RLS, arrays, generated columns, and kit push/pull defaults.

Build, update, or review React Router apps using createBrowserRouter, lazy route components, route objects, typed route builders, URL/search-param conventions, navigation APIs, pending UI, TanStack Query server state, and createRoutesStub testing. Use for client-owned React Router routing.

Build and review client-only React 19 code that treats components as pure UI projections, uses TanStack Query for server state, and avoids effect-driven orchestration and speculative optimization.

Reorganize a repository's agent guidance so AGENTS.md contains only critical rules and ruleset routing, `.agents/rules/` contains scoped rulesets, and `.agents/skills/` contains task-oriented workflow skills that do not need root signpost entries.

Use when refining an existing skill document so it better supports capable current and future models. Especially useful when a skill has become verbose, procedural, template-heavy, example-heavy, or overfit to current model weaknesses.

Create or update Codex skills, including SKILL.md structure, metadata, progressive disclosure, bundled resources, and agent-facing instructions.

Write text that avoids all known AI writing patterns and passes human detection. Use when writing articles, essays, blog posts, social media copy, or any content that must read as authentically human. Triggers on requests to write naturally, avoid AI slop, avoid AI detection, humanize writing, write like a human, or make text sound authentic.

Draft or refine technical design docs for libraries, SDKs, and subsystems, covering requirements, public APIs, runtime semantics, tradeoffs, failure modes, and blockers.

Use when a user asks to clarify, refine, strengthen, or edit selected text, pasted notes, requirements, specs, acceptance criteria, or documentation by asking only high-impact ambiguity questions and applying concise, durable improvements while preserving the user's intent and level of abstraction.

Use when a user asks to unpack, clarify, improve, operationalize, or rewrite a prompt or brief by extracting explicit details, implied requirements, design or execution choices, ambiguities, safe defaults, and next steps; especially for creative, product, UX, writing, research, planning, or artifact-generation prompts.

Create terminal screencast SVGs from command-line demos using asciinema and svg-term-cli, including recording, rendering, timing, framing, and README/docs embeds.

Add, configure, or debug Lingui internationalization in JavaScript or TypeScript apps using @lingui/core macros, Vite catalog loading, message extraction config, and dynamic locale activation. Use for non-JSX Lingui macro API work; avoid renderer-specific APIs unless the user explicitly asks.

Update the repository `spec/` tree as capability contracts that describe what the product must do, what boundaries it must respect, and how specs are organized.

Create, audit, rewrite, or repair downstream-user documentation for TypeScript libraries, including README decision support, public TSDoc, examples, docs/context.md, declaration emit, and API docs drift.

Read this guide when writing or editing documentation and deciding whether to add, omit, or revise a Mermaid diagram, especially when explaining workflows, dependencies, state transitions, system architecture, or actor interactions where visual structure may clarify the text.

Work on React UI using Ark UI, including component choice, part anatomy, accessibility, `asChild`, portals, presence, styling data attributes, fields, collections, lists, trees, overlays, and forms.

Work on Comark Markdown parsing, component syntax, AST transforms, streaming, React rendering, custom components, server/client rendering splits, and built-in plugins.

Work on Lexical editors in JavaScript or React, including `lexical`, `@lexical/react`, custom nodes, commands, transforms, listeners, selections, serialization, NodeState, and extensions.

Build, modify, and review Nitro v3 servers and Vite-integrated Nitro apps. Use when working with `nitro`, `nitro.config.ts`, `server.ts`, `routes/`, `middleware/`, Nitro route rules, handlers, renderer/SSR, storage, cache, database, tasks, WebSockets, OpenAPI, or migration from `nitropack` to `nitro`.

Work on Panda CSS styling, setup, and extraction, including `css`, `styled`, style props, patterns, recipes, tokens, presets, utilities, `panda.config.*`, and `styled-system`.

Compose compact product UI in apps already using Panda CSS, including screens, forms, lists, tables, empty states, action areas, local components, recipes, and semantic-token styling.

Compose compact product UI in apps already using Panda CSS and Ark UI, including screens, forms, lists, tables, empty states, action areas, local components, recipes, and semantic-token styling.

Build, theme, or debug semantic HTML UIs with Pico CSS, including `@picocss/pico`, build variants, Sass, CSS variables, forms, layouts, dropdowns, dialogs, navs, and tooltips.

Build and debug Atlassian Pragmatic drag and drop core package experiences, including element, external, and text-selection adapters, draggables, drop targets, monitors, events, cleanup, React integration, and reorder utilities.

Work on Pretext text measurement and manual layout, including DOM-free line metrics, text height prediction, shrinkwrapping, shaped text flow, columns, and inline fragment composition.

Build and debug React virtualization with @tanstack/react-virtual lists, window scrollers, grids, tables, sticky rows, infinite loading, measurement, and scroll positioning.

Work on React Virtuoso virtualization for lists, groups, grids, tables, window scrolling, and chat/message views, including component choice, scrolling, wrappers, UI integration, and measurement bugs.

Build, debug, and customize swup page transitions for server-rendered websites. Use when Codex needs to install swup, add page transition markup/CSS/JavaScript, configure swup options, reinitialize JavaScript after swup navigations, choose swup plugins or integrations, migrate swup versions, or troubleshoot hard page loads, scripts, styles, scroll, cache, hooks, and animations.

Use sem for semantic, entity-level code diffs, impact analysis, blame, entity listing, history logs, and compact AI context generation.

Author or maintain Preact components in `.tsrx` files, or set up TSRX in a Preact project when the user says "install TSRX" or "use TSRX". Includes TSRX component declarations, statement-position markup, scoped templates, render props, template control flow, and package setup guidance.