https://github.com/creativestyle/shopin-ai-tools
Agent skills for the SHOPin storefront accelerator - scaffold components, BFF modules, integrations & features.
https://github.com/creativestyle/shopin-ai-tools
Last synced: 23 days ago
JSON representation
Agent skills for the SHOPin storefront accelerator - scaffold components, BFF modules, integrations & features.
- Host: GitHub
- URL: https://github.com/creativestyle/shopin-ai-tools
- Owner: creativestyle
- License: mit
- Created: 2026-04-07T09:45:32.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-09T13:51:31.000Z (about 1 month ago)
- Last Synced: 2026-06-09T15:25:37.444Z (about 1 month ago)
- Homepage: https://www.shopin.dev/
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SHOPin AI Tools
Agent skills for working in the SHOPin codebase — adding components, features, BFF
modules, and integrations the way this project expects.
These are **project-specific** skills: they encode SHOPin's paths, conventions, and
quality checks. They're meant to be used inside (or alongside) the SHOPin monorepo,
not as general-purpose skills.
## Install
These skills follow the open [Agent Skills](https://skills.sh) layout, so you can
install them into any project with the [`skills` CLI](https://github.com/vercel-labs/skills) —
no separate package to publish, and nothing to install globally (`npx` runs it on demand):
```bash
# install all skills into the current project
npx skills add creativestyle/shopin-ai-tools
```
The CLI detects your agent and installs to the right place — `.claude/skills/` for
Claude Code, `.agents/skills/` for Cursor, Codex, GitHub Copilot, Gemini CLI, and ~70 others.
Install a single skill with the `--skill` flag:
```bash
npx skills add creativestyle/shopin-ai-tools --skill shopin-add-component
```
Other useful commands: `skills list`, `skills update`, `skills remove`.
## Using these in the SHOPin monorepo
These are companions to the [`creativestyle/shopin`](https://github.com/creativestyle/shopin)
storefront accelerator. Installing them is **optional and per-developer** — the monorepo
does not require them. Whoever wants them runs the command above inside their checkout;
whoever doesn't, does nothing.
## Skills
| Skill | Use when |
|-------|----------|
| `shopin-add-component` | Adding a UI component (Storybook story, test, translations). |
| `shopin-add-bff-module` | Exposing a new API endpoint/domain through the BFF. |
| `shopin-add-integration` | Connecting a new external data source behind the BFF. |
| `shopin-add-feature` | A full-stack feature spanning frontend, BFF, contracts, and integrations. |
Each skill is a self-contained folder under [`.agents/skills/`](.agents/skills/):
```
.agents/skills//
SKILL.md — domain guidance + an inlined Process section
references/ — examples to study before building
```
## Workflow
Every skill inlines a compact, tiered process: **trivial** changes just get done,
**small/low-risk** changes get one approval, and **non-trivial** work goes through a
staged spec → plan → execute flow with approval gates.
## Contributing
`.agents/skills/` is the source of truth. Edit the `SKILL.md` files directly —
each is self-contained, including its `## Process` section. When you change the
shared process, update the `Process` section in every skill so they stay
consistent. Skills are discovered automatically by the `skills` CLI from
`.agents/skills/` — no manifest to maintain.
## License
[MIT](LICENSE) © creativestyle GmbH
---
Brought to life by
