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.

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.

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…

Triage, investigate, draft, create or update GitHub issues using the organization triage runbook and current GitHub capabilities.

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

Review pull requests, diffs, and code changes in z-shell repositories against the bundled organization criteria and the repository's own contracts and checks, verifying each finding before reporting it. Read-only; does not authorize fixes or external writes.…

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…

Inspect GitHub Project 28 membership, update authorized delivery status or fields, and report portfolio progress for z-shell using the canonical tracker runbook. For issue investigation and disposition, use github-issues.

Prepare or update z-shell pull requests, inspect CI and review state after new commits, and hand off merge readiness using the canonical PR runbook. For reviewing code alone, use code-review.

Use when non-trivial project work is about to be declared complete, after unexpected failures or corrected assumptions, when a reusable procedure emerged, or when meaningful work is being handed off.

Install or update the Zi plugin manager on the user's machine, non-interactively, through the official installer and its flags, then verify the result. Runs only when the user invokes it, because it changes their machine. Never writes .zshrc or the Zi…

zd, Zi's Docker environment from z-shell/zd. Use when running Zi commands or the Zi ZUnit suite in a container or against a specific Zsh version, opening a clean shell with Zi loaded, testing a Zi revision from another repository, reproducing Linux Zsh…

Zsh plugins under the Z-Shell Zsh Plugin Standard 2. Use when creating a new Zsh plugin or plugin skeleton, or when maintaining an existing one, including bringing it to Standard 2, adding or changing functions, completions, configuration or unload, and…

ZUnit, the Zsh unit-testing framework from z-shell/zunit. Use when writing, running or debugging .zunit tests for a Zsh plugin or library, configuring .zunit.yml, or running a ZUnit suite in CI. Creating or restructuring the plugin itself belongs to…

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 in z-shell repositories against the bundled organization criteria and the repository's own contracts and checks, verifying each finding before reporting it. Read-only; does not authorize fixes or external writes.…

Fix a zsh-lint parser gap or wrong tree for valid Zsh in organization code or the external corpus, from proving it to the pull request's verification table. Advisory; the contract is docs/project/parser-gap-workflow.md.

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 the user's machine, non-interactively, through the official installer and its flags, then verify the result. Runs only when the user invokes it, because it changes their machine. Never writes .zshrc or the Zi…

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.