z-shell

Map z-shell wiki files, dependencies and tests for a requested investigation or a change whose scope needs clarification.

Pre-merge QA checklist for documentation changes. Use when reviewing a PR, preparing a release, or validating docs quality. Checks links, headings, category metadata, build output, and translation readiness.

Write or revise z-shell wiki documentation for its audience and task, using the appropriate Diataxis document type and repository authoring rules.

Identify and inspect missing context for a z-shell wiki question, asking the user only for information unavailable from the repository.

Audit consistency, performance, and style issues across the wiki codebase; apply fixes only when the user explicitly authorizes remediation. Use when reviewing code quality, preparing releases, onboarding contributors, or after bulk changes to TypeScript…

Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine…

Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and…

Apply consistent visual design when creating or reviewing UI components. Covers design tokens, component patterns, glass-morphism cards, responsive grids, and accessibility. Use when building new homepage sections, auditing visual consistency, or reviewing…

Use when a task depends on what Zsh itself does, such as investigating a zsh-lint parser gap, false accept, or rule proposal, deciding whether a construct is valid Zsh, or explaining an expansion, option, or builtin. Grounds the answer in the released Zsh…

Install or update the Zi plugin manager on a user's machine on their behalf, non-interactively, through the official installer and its flags, then verify the result. Never write .zshrc or the Zi configuration home directly.

Create or refactor a repository README with polished GFM styling, valuable links, and high-clarity structure

Use when a user asks to create a new Zsh plugin, start a plugin from scratch, or add a plugin skeleton.

Review pull requests, diffs, and code changes using repository contracts and checks, or assess review readiness during repository-health evaluations. Produce evidence-based findings without authorizing fixes or external writes.

Investigate, assess, read, draft, create, or update GitHub issues with current-state verification, value-versus-cost analysis, runtime capability discovery, and exact write boundaries.

Use when a user asks to add tests for a Zsh plugin, write a .zunit test, or run a ZUnit suite.

Use GitHub CLI safely by discovering the installed version and command capabilities, defaulting to read-only inspection, and requiring explicit authority for every external write.

Review pull requests, diffs, and code changes using repository contracts and checks, or assess review readiness during repository-health evaluations. Produce evidence-based findings without authorizing fixes or external writes.

Review pull requests, diffs, and code changes using repository contracts and checks, or assess review readiness during repository-health evaluations. Produce evidence-based findings without authorizing fixes or external writes.

Fix a zsh-lint parser gap or false accept end to end, from proving it with both oracles to the pull request's verification table. Use for any change under internal/parse that makes valid Zsh parse or invalid Zsh fail. Advisory; the contract is…

Review pull requests, diffs, and code changes using repository contracts and checks, or assess review readiness during repository-health evaluations. Produce evidence-based findings without authorizing fixes or external writes.

Install or update the Zi plugin manager on a user's machine on their behalf, non-interactively, through the official installer and its flags, then verify the result. Never write .zshrc or the Zi configuration home directly.

Review pull requests, diffs, and code changes using repository contracts and checks, or assess review readiness during repository-health evaluations. Produce evidence-based findings without authorizing fixes or external writes.