zsh-writer

Create and maintain ZSH functions with bats-based testing workflows.

38|6|Updated Sep 13, 2012
One-click install
npx skills add https://github.com/pixelastic/oroshi --skill zsh-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zsh-writer
Source: https://github.com/pixelastic/oroshi/tree/main/tools/ai/claude/config/skills/zsh-writer
Command: npx skills add https://github.com/pixelastic/oroshi --skill zsh-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Writing and maintaining ZSH functions can be error-prone and inconsistent. This skill provides a structured approach to creating and updating ZSH code that adheres to conventions and testing workflows.

Core Features & Use Cases

  • Autoload-friendly function templates with proper error protection
  • Step-by-step TDD workflow including failing test creation
  • Guidance for linting and consistent style across functions
  • Use cases: creating new autoloaded commands, refactoring existing ZSH code, adding tests with bats

Quick Start

Place a new ZSH function file at the correct path and name following the conventions described in the Core Workflow.

Frequently Asked Questions about zsh-writer

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

FAQPage Schema
How do I write clean ZSH functions with proper error handling?

Clean ZSH functions use autoload-friendly templates with proper error protection and follow standardized conventions for code structure and error handling to maintain consistency across projects.

How do I set up bats testing for my ZSH functions?

Set up bats testing for ZSH functions by following a step-by-step TDD workflow that begins with creating a failing test, then writing the function logic until the test passes.

What is the best way to structure autoloaded ZSH commands?

Structure autoloaded ZSH commands by placing the function file at the correct path and naming it according to established conventions, ensuring proper metadata and linting compliance.

Can I use TDD to refactor existing ZSH code safely?

Yes, you can use TDD to refactor existing ZSH code safely by applying standardized testing workflows and linting guidance to enforce consistent style and verify functionality throughout the refactoring process.

Does ZSH function linting require frontmatter metadata?

Yes, ZSH function linting requires satisfying frontmatter metadata as part of the standardized workflow, ensuring functions adhere to project conventions and pass style checks consistently.