goss
Use this skill when the user wants to validate server configuration, Docker containers, or infrastructure state with fast YAML-based tests — health checks, package presence, port listening, file contents, and HTTP endpoints.
Source facts
- Repository
- javimosch/supercli
- Last source activity
- July 20, 2026 at 18:36
- 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
- goss
- description
- Use this skill when the user wants to validate server configuration, Docker containers, or infrastructure state with fast YAML-based tests — health checks, package presence, port listening, file contents, and HTTP endpoints.
# goss Plugin
Quick and Easy server testing. Define infrastructure expectations as YAML and run them in milliseconds — ideal for CI, Docker image validation, and post-deploy smoke tests.
## Installation
```bash
curl -fsSL https://goss.rocks/install | sh
# or
brew install goss
```
## Basic Usage
```bash
# Auto-generate tests from current system state
goss add package nginx
goss add port 80
goss add file /etc/nginx/nginx.conf
# Run validation
goss validate
# Validate a Docker image
dgoss run myimage:latest /goss/goss validate
```
## Common Patterns
```bash
# Write tests to goss.yaml
goss add service ssh --port 22
# Validate with formatted output
goss validate --format documentation
# Validate against a remote host
goss validate --endpoint tcp://myserver:22
```
## Usage Examples
- "Check that nginx is installed and port 80 is listening"
- "Validate this Docker image has the right packages"
- "Generate goss tests from the current server state"
## SuperCLI
```bash
sc goss _ _ validate
sc goss _ _ add port 8080
sc plugins learn goss
```
View on GitHub