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

# Install the Onsomble skills

> Teach your agent to use Onsomble well with the Agent Skills pack.

Connecting the MCP server gives an agent access to your data. The Onsomble skills teach it competence: which tool to reach for in which order, what each metric does and does not mean, and what a credible analysis looks like. Install them alongside any [MCP connection](/developers/connect/claude).

They use the open [Agent Skills](https://agentskills.io) format supported by Claude Code and a growing set of agent tools: a `SKILL.md` and the reference files the agent reads on demand.

## What's in it

| File | What it teaches |
| - | - |
| `SKILL.md` | Tool selection, interpretation rules, output shape |
| `references/metrics-guide.md` | Each metric's definition, scale, and common misreads |
| `references/filter-vocabulary.md` | Platform IDs, regions, dates, and the consistency rule |
| `references/workflows.md` | Visibility audit, competitor review, post-Scan triage |
| `references/interpretation-guardrails.md` | Conclusions the data cannot support |
| `examples/sample-analysis.md` | One worked example of a good analysis |

## Install in Claude Code

From your project root, fetch the pack into `.claude/skills/` (use `~/.claude/skills/` instead to install it for every project):

```bash theme={null}
mkdir -p .claude/skills/onsomble/references .claude/skills/onsomble/examples
for file in SKILL.md \
  references/metrics-guide.md \
  references/filter-vocabulary.md \
  references/workflows.md \
  references/interpretation-guardrails.md \
  examples/sample-analysis.md; do
  curl -fsSL "https://docs.onsomble.ai/skills/onsomble/$file" \
    -o ".claude/skills/onsomble/$file"
done
```

Claude Code picks the skill up automatically and applies it whenever a conversation turns to AI visibility work.

## Install in other agent tools

Any tool that supports the Agent Skills format uses the same folder: place the `onsomble/` directory in that tool's skills location. For tools without skills support, the files are plain Markdown — [read them directly](https://docs.onsomble.ai/skills/onsomble/SKILL.md) and include what you need in your agent's instructions.

## Keeping it current

The pack is versioned with the MCP server: when the tool catalog changes, the skill changes with it. Re-run the install snippet to pick up the latest version.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.