zsh-style-guide

Enforce consistent Zsh scripting style and quality controls during code reviews.

7|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/KentoShimizu/sw-agent-skills --skill zsh-style-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zsh-style-guide
Source: https://github.com/KentoShimizu/sw-agent-skills/tree/main/skills/zsh-style-guide
Command: npx skills add https://github.com/KentoShimizu/sw-agent-skills --skill zsh-style-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Inconsistent Zsh scripting standards across teams lead to hard-to-maintain scripts, subtle bugs, and divergent behavior across environments.

Core Features & Use Cases

  • Standardized style guidelines for Zsh scripts and environment-related files to improve readability and reliability.
  • Co-activation with triggers like CI pipelines and common Zsh file patterns (e.g., .zshrc, #!/usr/bin/env zsh) to ensure coverage during reviews.
  • Use cases include reviewing and refactoring PRs that touch Zsh configs, scripts, and CI workflows labeled shell: zsh.

Quick Start

Review a PR touching Zsh scripts or config files and apply the Zsh style-guide checks to enforce consistency.

Frequently Asked Questions about zsh-style-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce consistent Zsh scripting style across my projects?

You enforce consistent Zsh scripting style by applying standardized style guidelines to your Zsh scripts and config files. This improves readability and reliability across your codebase during code reviews and CI checks.

Can I use a Zsh style guide to review pull requests in CI pipelines?

Yes, you can use a Zsh style guide in CI pipelines. It co-activates with CI workflows labeled shell: zsh and common Zsh file patterns to ensure style rules are enforced automatically during the merge process.

What problem does standardizing Zsh scripts solve for a team?

Standardizing Zsh scripts solves the problem of inconsistent team standards that lead to hard-to-maintain scripts, subtle bugs, and divergent behavior across different environments. It improves overall code quality and maintainability.

How do I check Zsh code quality in files with a Zsh shebang?

You check Zsh code quality by applying style rules to files featuring Zsh shebangs like #!/usr/bin/env zsh. This triggers automated co-activation to review and refactor scripts for consistency and reliability.

Does a Zsh style guide work with existing .zshrc configurations?

Yes, a Zsh style guide works with existing .zshrc configurations. It co-activates with common Zsh file patterns to apply quality controls and standardize environment-related files during pull request reviews.

What are the limitations of using a style guide for Zsh codebases?

The style guide focuses on reviewing and maintaining Zsh codebases, including scripts and CI workflows. It requires a SKILL.md frontmatter and optional references, meaning it operates within these defined structural parameters for consistency checks.