> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squasher.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Install Squasher Agent Skills so coding assistants know the Squasher CLI and hosted MCP server.

Agent Skills package Squasher-specific workflows for AI coding assistants. Use them when an assistant needs durable context for the Squasher CLI, hosted MCP server, or observability workflows.

Skills are helper documentation for agents, not the product contract. The stable contracts are the public API, CLI behavior, MCP tool schemas, and Code Mode operation types. Install skills to help an agent choose the right Squasher surface and avoid stale setup or query guidance.

## Available skills

| Skill          | Use when                                                                                                        | What it prevents                                                                                        |
| -------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `squasher-cli` | The user asks for `squasher` commands, says "squash CLI", or wants to inspect Squasher data from a terminal.    | Invented `squash` commands, stale flags, missing `--project` scoping, and unsafe API-key handling.      |
| `squasher-mcp` | The user wants to connect Squasher to Claude Code, Cursor, VS Code, Codex CLI, OpenCode, or another MCP client. | Wrong MCP URLs, incorrect OAuth/API-key setup, made-up tool names, and unbounded observability queries. |

## Install

If your assistant supports the open Agent Skills format, install the Squasher skills from the git source that contains the Squasher `.agents/skills` directory:

```bash theme={null}
npx skills add <squasher-skills-source> --skill squasher-cli
npx skills add <squasher-skills-source> --skill squasher-mcp
```

`<squasher-skills-source>` can be a GitHub `owner/repo`, a direct git URL, a direct repository tree URL, or a local path supported by the skills CLI.

For project-local installation without a package manager, copy the skill folders into your repository:

```text theme={null}
.agents/
`-- skills/
    |-- squasher-cli/
    |   |-- SKILL.md
    |   `-- references/
    `-- squasher-mcp/
        |-- SKILL.md
        `-- references/
```

If you already have a local checkout that contains these folders, install from the local path:

```bash theme={null}
npx skills add ./.agents/skills/squasher-cli
npx skills add ./.agents/skills/squasher-mcp
```

## Use the skills

After installation, start a new agent session and ask for the skill explicitly:

```text theme={null}
Use $squasher-cli to show me the command for listing unresolved errors in this project.
```

```text theme={null}
Use $squasher-mcp to connect Claude Code to Squasher with OAuth.
```

Most assistants also activate a skill implicitly when your prompt matches its description. Explicit invocation is still useful when you are testing a new install.

## Verify

Run your assistant's skills command, if available:

```text theme={null}
/skills
```

Confirm that `squasher-cli` and `squasher-mcp` appear in the list.

Then test with a prompt that should not require live project data:

```text theme={null}
What is the Squasher MCP server URL for Codex CLI?
```

The answer should include:

```text theme={null}
https://mcp.squasher.ai/mcp
```

## Related docs

* [MCP](/integrations/mcp)
* [CLI Integration Setup](/integrations/cli-oauth)