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

# Agent Skills

> Teach your AI assistant how to build on Ollie Shop: the CLI, the SDK, checkout slots, design tokens, hub functions, and the workflows that tie them together.

When you customize Ollie Shop, your AI assistant only helps as much as it knows the platform. The **Ollie Shop agent skill** is a packaged set of instructions that teaches your assistant the platform (the CLI commands, the SDK hooks, the checkout slots, the design contract, hub functions) so it can write working code instead of inventing APIs.

## What your AI gets

Once the skill is installed, your assistant knows how to:

* Use the `ollieshop` CLI: deploy, login, create components, manage versions and business rules.
* Build custom checkout components using `@ollie-shop/sdk` hooks (`useCheckoutSession`, `useCheckoutAction`, and others).
* Pick the right checkout slot for a customization, with the full slot catalog as context.
* Follow the design contract: tokens, accessibility, motion, complexity rules.
* Write hub functions for request/response middleware on the Ollie Hub.

## Where the skill lives

Projects scaffolded with `npx create-ollie-shop` arrive with the skill already installed at `.claude/skills/ollie-shop/`. There's nothing extra to do. Your assistant picks it up automatically the first time you ask it for help on the project.

If you're working in a project that doesn't have the skill yet, install it with the [`skills`](https://www.npmjs.com/package/skills) CLI:

```bash theme={"system"}
npx skills add ollie-shop/skills --agent claude-code
```

<Info>
  Using Cursor, Windsurf, or another supported agent? Swap the flag for `--agent cursor`, `--agent windsurf`, etc. Without `--agent`, the CLI tries to symlink across all agents at once, which requires Developer Mode on Windows. For the full list, run `npx skills add --help`.
</Info>

## Updating

The skill evolves as Ollie Shop ships new SDK hooks, CLI flags, slots, and patterns. To pull the latest version into a project that already has it, run the install command again:

```bash theme={"system"}
npx skills add ollie-shop/skills --agent claude-code
```

The current version installed in your project is recorded in `.claude/skills/ollie-shop/.version`, for example:

```
1.0.1
```

## Verifying the install

After running the install command, the project should have:

```
.claude/skills/ollie-shop/
├── .version
├── SKILL.md
├── assets/
└── references/
```

If the directory is missing, the most common cause on Windows is the symlink fallback failing. Re-run with `--agent claude-code` to force a direct copy instead of a symlink.

## License

The skill content is published under the [MIT License](https://github.com/ollie-shop/skills/blob/main/LICENSE) and is free to use, modify, and redistribute.