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, 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 CLI: 
npx skills add ollie-shop/skills --agent claude-code
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.

​
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: 
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 and is free to use, modify, and redistribute.