Agent Skills

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:

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:

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

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:

Use $squasher-cli to show me the command for listing unresolved errors in this project.

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:

/skills

Confirm that squasher-cli and squasher-mcp appear in the list. Then test with a prompt that should not require live project data:

What is the Squasher MCP server URL for Codex CLI?

The answer should include:

https://mcp.squasher.ai/mcp

Get Started

SDKs

Integrations

Migrations

Cloud Log Drains

Features

API Reference

Available skills

Install

Use the skills

Verify

​Available skills

​Install

​Use the skills

​Verify

​Related docs

Available skills

Install

Use the skills

Verify

Related docs