dot

Set up QMD in a repository with repository scanning, collection planning, YAML-defined collections, and approval-gated execution. Use when I need local markdown indexing/search initialized or adjusted.

Search local markdown knowledge bases, notes, docs, and wikis with QMD. Use when users ask to find notes, retrieve documents, inspect a wiki, or answer from indexed markdown.

Execute deterministic story plans through dependency-aware workflow state transitions, PR/card lifecycle discipline, and critique-gated completion. Use when implementing an existing multi-story plan artifact.

Use when creating, editing, auditing, or restructuring agent instruction entrypoints (`SKILL.md`, `AGENTS.md`, `CLAUDE.md`, subagent/agent definitions). Consolidate duplicate or conflicting rules, improve skill description discoverability, and validate metadata, assets, and cross-file consistency.

Produce deterministic execution plans with story artifacts ready for workflow-driven delivery. Use when tasks are multi-step, high-risk, ambiguous, or span multiple files/services.

Organize per-repo agentic project workspaces under .agents/projects/<project-name>. Use when initializing or maintaining project prompts, plans, research, and temporary artifacts.

Create branches and commits from local diffs with correct commit message conventions. Use when asked to branch, split commits, write commit messages, or apply commitlint/Conventional Commits rules.

Migrate ESLint or other linters to Rslint. Use when asked to replace ESLint flat config, lint scripts, VS Code ESLint settings, inline directives, rules, presets, plugins, or lint dependencies with Rslint equivalents.

Migrate Jest or Vitest test suites and configs to Rstest. Use when asked to move from Jest/Vitest to Rstest, replace framework APIs with `@rstest/core`, translate test config to `rstest.config.ts`, or update test scripts and setup files for Rstest equivalents.

Use when analyzing Rspack/Webpack bundles from local `rsdoctor-data.json` and producing evidence-based optimization recommendations.

Opinionated Rslib recommendations for modern JS/TS npm package design covering pure ESM, strict TypeScript, explicit exports, small stable APIs, pragmatic dependencies, accurate sideEffects, correct declarations, package validation, provenance, README.md, and AGENTS.md. Use when I want to make a JS/TS package more modern, check whether the current package setup is healthy, review package.json/exports/types/dependencies/docs/release readiness, or apply a modern library baseline.

Debug Rspack crashes, hangs, deadlocks, and coredumps with LLDB-focused workflows. Use when users report segmentation faults, unstable HMR crashes, stuck build/devserver processes, or async deadlocks.

Diagnose and optimize Rspack `optimization.splitChunks` configuration. Use this when a user wants better production chunking, safer `chunks: "all"` defaults, fewer duplicated modules, better long-term caching, `cacheGroups` design help, `maxSize` tuning, or debugging over-fetch caused by `name` and forced chunk merging.

Diagnose Rspack performance bottlenecks and trace-based build-stage failures with tracing and profiling workflows. Use when users need hook-level timing analysis, trace inspection, or help locating slow or failing build stages.

Customize Rspress themes using CSS variables, Layout slots, component wrapping, or component ejection. Use when I want to change the look and feel of an Rspress site, override theme components, add custom navigation/sidebar/footer content, inject global providers, or modify the default Rspress theme in any way. Also use when I mention theme/index.tsx, Layout slots, BEM class overrides, or rspress eject.

Use TanStack CLI for app scaffolding, add-on management, docs lookup, and MCP migration whenever a project uses TanStack tools or I ask for TanStack workflows.

Evaluate agent-instruction behavior and discoverability with repeatable baselines, assertion grading, benchmark deltas, and iteration loops. Use when revising skills, AGENTS.md, CLAUDE.md, or agent-definition instructions.

Migrate webpack, Vite, create-react-app (CRA/CRACO), or Vue CLI projects to Rsbuild. Use when users ask to replace an existing build setup with Rsbuild while preserving current behavior.

Migrate tsc or tsup library projects to Rslib. Use when users ask to replace tsc/tsup library build pipelines with Rslib while keeping package behavior stable.

Generate and maintain description frontmatter for Rspress documentation files (.md/.mdx). Use when a user wants to add SEO descriptions, improve search engine snippets, generate llms.txt metadata, prepare docs for AI summarization, or batch-update frontmatter across an Rspress doc site. Also use when adding new documentation pages to an Rspress project — every new doc file needs a description.

Debug Rstest performance issues and regressions. Use when Rstest is slower than expected, slower than Jest or Vitest, slower than a previous baseline, or when tests spend a long time before starting.

Add, modify, or invoke mise tasks (file tasks and TOML tasks); wire task help via usage directives; run tasks with mise run. Use when adding, modifying, running, or debugging tasks in a mise-managed project.

Author and maintain setup, automation, and bootstrap scripts. Use when creating or modifying shell/task scripts, install flows, or system initialization routines.

Apply Zsh shell scripting conventions for error safety and logging. Use when authoring, modifying, or reviewing Zsh scripts, including mise file tasks and bootstrap scripts.

Rsbuild best practices for config, CLI workflow, type checking, bundle optimization, assets, and debugging. Use when writing, reviewing, or troubleshooting Rsbuild projects.

Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.

Rslib best practices for config, CLI workflow, output, declaration files, dependency handling, build optimization and toolchain integration. Use when writing, reviewing, or troubleshooting Rslib projects.

Rspack best practices for config, CLI workflow, type checking, CSS, bundle optimization, assets and profiling. Use when writing, reviewing, or troubleshooting Rspack projects.

Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.

Rspress best practices for config, CLI workflow, content organization, frontmatter, MDX, themes, i18n, search, static assets, deployment, and debugging. Use when writing, reviewing, or troubleshooting Rspress documentation sites.

Rstest best practices for config, CLI workflow, test writing, mocking, snapshot testing, DOM testing, coverage, multi-project setup, CI integration, performance and debugging. Use when writing, reviewing, or troubleshooting Rstest test projects.

Guide Node package-manager execution across bun, npm, and bunx/npx. Use when installing dependencies, running scripts, or invoking Node CLIs, while preferring bun/bunx when available and respecting project standards.

Apply repository coding standards for implementation and review tasks. Use when adding features, fixing bugs, refactoring, updating tests, or resolving lint/type/build issues.

Run linters and respond to lint failures across languages and hook-managed projects. Use when running checks, fixing lint or format issues, recovering from pre-commit failures, scoping a lint run to changed files or the whole tree, or invoking individual `hk` steps.

Apply Markdown authoring conventions for clarity, link style, and table-of-contents discipline. Use when writing or editing Markdown files, documentation, READMEs, or instruction files.

Use the `gh` CLI for pull requests, issues, workflow runs, releases, repository metadata, and file content on GitHub. Use when interacting with any GitHub resource from the terminal.

Apply Hammerspoon macOS automation and window management configuration rules. Use when working with Hammerspoon scripts, Spoons, hotkeys, or window management Lua code.

Apply Lua authoring conventions for Neovim, Hammerspoon, WezTerm, and Yazi configurations. Use when writing, editing, or refactoring Lua modules, plugin configs, or scripts in this repository.

Apply LazyVim Neovim configuration rules for Lua scripting, LSP integration, and plugin management. Use when working with Neovim configuration files, plugins, or Lua modules.

Sync GitHub Copilot model alias names in OpenCode config with current paid multipliers from github/docs. Use when asked to refresh or update OpenCode Copilot alias multiplier labels.