Scrut is a testing tool for command-line interfaces that uses Markdown files to define expectations and assertions for shell commands.

How does it handle dynamic output like timestamps?

It utilizes Scrut's glob and glob+ patterns to match variable-length or dynamic data while still pinning the stable parts of the output.

Where are the tests stored?

Following standard conventions, the skill organizes test files within the tests/scrut/ directory at your repository root.

Can I use this for Zsh plugins?

Yes, the skill includes specific conventions and commands for testing sourced Zsh libraries and plugins using the --shell zsh flag.

Does it support error testing?

Yes, it simplifies testing exit codes and stderr output, providing patterns for precise error message validation and redirection.

Scrut CLI & Zsh Testing

Name: Scrut CLI & Zsh Testing
Author: cboone

bycboone

•

Security & Testing

Generates and maintains high-quality Scrut test suites for CLI binaries and Zsh plugins using standardized style conventions.

This skill empowers developers to build robust, maintainable test suites for command-line interfaces and Zsh libraries by enforcing the Scrut test style guide. It automates the creation of test files in tests/scrut/, handles complex assertions like globs and regex for dynamic outputs, and provides specialized patterns for Zsh plugin validation. Whether you are pinning help text for stability or testing error exit codes, this skill ensures consistency across your project's testing infrastructure and simplifies the review process for long-term maintainability.

Key Features

01Specialized support for testing Zsh plugins and sourced libraries

02Supports precise output matching using glob, glob+, and regex patterns

031 GitHub stars

04Handles binary invocation best practices like NO_COLOR=1 and dynamic binary paths

05Enforces standardized Scrut test style conventions and file organization

06Automates error condition testing with exit code validation and stderr redirection

Use Cases

01Maintaining and updating Scrut test snapshots during rapid development cycles

02Developing automated test suites for Zsh-based plugins and shell libraries

03Creating regression tests for CLI tool help menus and flag validation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cboone/cboone-cc-plugins write-scrut-tests

For use in Claude.ai and ChatGPT

Download Skill