bats
Use this skill when the user wants to write or run Bash shell tests — TAP-compliant test suites, CI integration, mocking, and parallel test execution.
Source facts
- Repository
- javimosch/supercli
- Last source activity
- July 20, 2026 at 22:58
- Detected SKILL.md language
- English
- Stars
- 51
- Forks
- 7
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- bats
- description
- Use this skill when the user wants to write or run Bash shell tests — TAP-compliant test suites, CI integration, mocking, and parallel test execution.
# bats Plugin
Bash Automated Testing System. Write unit and integration tests for shell scripts with readable syntax, TAP output, and first-class CI support.
## Installation
```bash
npm install -g bats
# or
brew install bats-core
# Debian/Ubuntu: apt install bats
```
## Basic Usage
```bash
# Run a single test file
bats test/example.bats
# Run all tests in a directory
bats test/
# Count tests without running
bats --count test/
```
## Common Patterns
```bash
# Filter tests by name pattern
bats --filter "login" test/
# Parallel execution
bats --jobs 4 test/
# TAP output for CI
bats --tap test/
# JUnit XML for reporting
bats --formatter junit test/ > report.xml
```
## Writing Tests
```bash
# example.bats
@test "addition works" {
result=$(echo $((2 + 2)))
[ "$result" -eq 4 ]
}
```
## Usage Examples
- "Run all Bash tests in the test/ directory"
- "Filter bats tests matching 'deploy'"
- "Output bats results in TAP format for CI"
## SuperCLI
```bash
sc bats test run test/example.bats
sc bats _ _ --filter "auth" test/
sc plugins learn bats
```
View on GitHub