Skip to main content
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, and manage versions.
  • 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 .agents/skills/ollie-shop/, alongside an AGENTS.md at the project root that points your coding agent at it. There’s nothing extra to do. The directory name is deliberately agent-neutral. The skill is plain markdown, so any assistant that can read a file can use it. What differs between tools is whether they find it on their own.

​
Installing it yourself

If you’re working in a project that doesn’t have the skill yet, or you want it filed where your agent looks natively, install it with the skills CLI:
Omit --agent and the CLI detects the agents you already have and confirms before writing anything. Pass it to target one explicitly: --agent cursor, --agent windsurf, --agent gemini. Run npx skills add --help for the full list.

​
Which agents pick it up automatically

Claude Code users who want the skill loaded through Claude’s native skill mechanism, matched automatically from its description rather than through AGENTS.md, can install it into .claude/skills/ with the command above. Both routes work; the native mechanism just picks the skill up without reading AGENTS.md first.

​
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. The version currently installed in your project is recorded in the skill’s .version file, for example .agents/skills/ollie-shop/.version. Compare it against the published releases to see whether you’re behind.

​
Verifying the install

After running the install command, the project should have:

​
License

The skill content is published under the MIT License and is free to use, modify, and redistribute.