# Skills for AI agents

A skill is a folder with one `SKILL.md` file of instructions for a coding agent. The Beauty Router skills give your agent
the rules a correct integration must follow and the order of the calls. The agent picks a skill from its description, so
it loads the right one when you ask it to work on that part of your integration.

The skills hold rules and steps. For exact fields, they link to the Markdown version of these docs, so the agent reads the
current page.

## The skills

| Skill                                                                 | What it covers                                                                |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [`beauty-router-connect`](/skills/beauty-router-connect/SKILL.md)     | Tokens, login, environments, setup, errors, and conventions.                  |
| [`beauty-router-embed`](/skills/beauty-router-embed/SKILL.md)         | The JavaScript library, every `show…` function, and the Beauty Router mark.   |
| [`beauty-router-orders`](/skills/beauty-router-orders/SKILL.md)       | Offers, quotes, order creation, drafts, statuses, order changes, and charges. |
| [`beauty-router-companies`](/skills/beauty-router-companies/SKILL.md) | Company details, documents, verification, services, and the payment card.     |
| [`beauty-router-catalog`](/skills/beauty-router-catalog/SKILL.md)     | Catalog files, search, product matching, suppliers, and delivery estimates.   |
| [`beauty-router-webhooks`](/skills/beauty-router-webhooks/SKILL.md)   | Signature checks, secrets, retries, event types, and emails to salon users.   |

## Install

Copy each skill into your agent's project skills folder:

| Agent       | Folder           |
| ----------- | ---------------- |
| Claude Code | `.claude/skills` |
| Codex       | `.agents/skills` |
| Cursor      | `.cursor/skills` |

This command, run from the root of your project, installs all six for Claude Code. For another agent, change
`.claude/skills` to that agent's folder.

```bash
for s in connect embed orders companies catalog webhooks; do mkdir -p ".claude/skills/beauty-router-$s" && curl -fsSL "https://docs.beautyrouter.com/skills/beauty-router-$s/SKILL.md" -o ".claude/skills/beauty-router-$s/SKILL.md"; done
```

Run the same command again to get the latest version of the skills.