antithesis-documentation

What this skill does

# Antithesis Documentation

## Antithesis Overview

Antithesis is a testing platform that works like a specialized staging environment. You ensure your software is reliable by deploying it to Antithesis and running it there before you deploy it to production. It supplements your existing testing tools and lives alongside your normal CI/CD workflow.

When you deploy to Antithesis, your software runs in a simulation environment that is much more hostile than production. This quickly exposes bugs, including complicated, unlikely, and severe failures.

Because Antithesis's environment is perfectly deterministic, problems are reproducible with minimal effort. Unlike typical shared staging, you do not need to compete for deployment locks or worry about environmental drift since every deployment is completely isolated from one another.

## Accessing Documentation

The best way to access Antithesis documentation on the command line is via the Antithesis CLI which is called snouty.

Run `snouty docs --help` to get started.

## If `snouty` is missing

1. Tell the user `snouty` is the Antithesis CLI.
2. Point them to the install source: `https://github.com/antithesishq/snouty`
3. Ask whether they want you to install it. If yes, follow instructions in `https://raw.githubusercontent.com/antithesishq/snouty/refs/heads/main/README.md`.
4. After installation, re-run `snouty --help`.

## Using `snouty docs`

Use `snouty docs` to discover authoritative Antithesis documentation before giving detailed guidance. Inspect `snouty docs --help` to discover subcommands and usage examples.

Recommended workflow:

1. Start with `snouty docs tree --depth 2` to get a quick overview of the docs.
2. Use `snouty docs tree <filter>` to explore a section when you know the area but not the exact page name.
3. Use `snouty docs search <terms>` to find likely pages for a specific topic.
4. Use `snouty docs search -l <terms>` when you want just the page paths.
5. Use `snouty docs show <path>` to read the full markdown page once you know the path.
6. Cite the relevant documentation pages in your answer.

Useful details:

- `snouty docs show` accepts page paths like `using_antithesis/sdk/go`.
- `snouty docs show` also accepts `/docs/.../` style paths and tries to normalize them for you.
- A warning about failing to update docs and falling back to cached docs is usually fine, especially in sandboxes without network access. Treat it as non-fatal if the requested docs content is still returned.
- `snouty docs sqlite` prints the path to a local SQLite database containing all of the Antithesis documentation. Use this if you want to directly query the docs.

## Direct Markdown Fallback

If `snouty` is unavailable, you may fetch markdown pages directly from `https://antithesis.com/docs/`.

A plain text index of all markdown pages is available at `https://antithesis.com/docs/llms.txt`. Load this first.

Always add the `.md` extension before requesting files from `https://antithesis.com/docs/`.

Examples:

- `https://antithesis.com/docs/using_antithesis/sdk/go/` becomes `https://antithesis.com/docs/using_antithesis/sdk/go.md`
- `/using_antithesis/sdk/go/` becomes `https://antithesis.com/docs/using_antithesis/sdk/go.md`

Exceptions:

- URLs with explicit file extensions such as `.txt`, `.js`, or `.so`
- `docs/generated/...` paths should be requested as-is

When presenting links to the user, prefer the normal HTML page URL instead of the `.md` URL.

If you want to link a user directly to a section, use a fragment with the slugified header when practical. If the slug is uncertain, link the page and name the section explicitly.

## Output

- Clear, grounded answers about Antithesis behavior, SDKs, setup, and best practices.
- Relevant links to the documentation pages you used.
- If the `snouty` command is missing ask the user if they want to install it, telling them that it is a CLI for working with the Antithesis API and docs.

## Self-Review

Before declaring this skill complete, review your work against the criteria below. This skill's output is conversational (answers grounded in documentation), so the review should happen in your current context. Re-read the guidance in this file, then systematically check each item below against the answers you produced.

Review criteria:

- Every factual claim in your answer is grounded in a specific documentation page you retrieved via `snouty docs` or direct markdown fetch
- Documentation page links are included so the user can verify your sources
- You have not mixed up concepts from different pages or added details not present in the source material
- If the docs were ambiguous or silent on a point, you said so rather than filling the gap with assumptions