# 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.

- Skill: `javimosch/goss` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/goss`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/goss/raw
- Safety review: WARNING (external: skill-scanner WARNING, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/goss

---


# 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
```