# Quick start
Source: https://docs.ratel.sh/quickstart

The fastest way to adopt Ratel is to not write the integration yourself. Ratel ships five open-source skills for coding agents (Claude Code, Cursor, Codex, and 40+ others) that audit your agent codebase, plan its observability, integrate Ratel, and fix what the audit finds.

Prefer to write the code by hand? Jump to [the SDK quickstarts](#write-the-code-yourself).

## Install the skills

**npm**

```bash
npx skills add ratel-ai/skills -y --all
```

**pnpm**

```bash
pnpm dlx skills add ratel-ai/skills -y --all
```

**yarn**

```bash
yarn dlx skills add ratel-ai/skills -y --all
```

**bun**

```bash
bunx skills add ratel-ai/skills -y --all
```

That installs all five skills into the current project (`./.claude/skills/` for Claude Code, the equivalent location for other supported agents). The `-y` flag accepts all prompts; `--all` installs all skills into all agents; add `-g` to install globally (`~/.claude/skills/`).

## Paste this into your coding agent

Want a read on your agent first? The assessment is free and static (no setup):

```text
Run npx skills add ratel-ai/skills --all and use the skills to assess the agents in this codebase
```

Ready to wire Ratel in? Go straight to the integration plan:

```text
Run npx skills add ratel-ai/skills --all and use the skills to integrate Ratel in this project.
```

Either entry point pulls in the whole suite. The assessment writes a report to `.ratel/ratel-assessment-<date>.md`, plus a branded, scored HTML version alongside it. The report ends with "Recommended next steps": every finding routes to the right follow-up skill, so you don't have to know the arc up front.

What the five skills do, how they chain, and how observability fits: [Skillset](/skillset).

## Write the code yourself

Everything the skills plan and apply, you can also write by hand: register your tools and prompt playbooks in Ratel catalogs, then hand your agent the three capability tools: `search_capabilities`, `invoke_tool`, `get_skill_content`. The per-language quickstarts cover both starting from scratch and migrating an existing agent:

[TypeScript quickstart](/typescript/quickstart)

Install @ratel-ai/sdk, create the ratel() core, and run the discovery loop: no framework required.

[Python quickstart](/python/quickstart)

The same path with ratel-ai, idiomatic Python.

> **Using Claude Code or Codex as your agent runtime?**
>
> [Ratel Local](/local/quickstart) puts the same capability contract in front of your
> existing MCP servers: no code at all.