Appearance
AI Integration Assistant
The POS Hub integration assistant is a skill for AI coding agents such as Claude Code. Install it once, then ask your agent about POS Hub, or ask it to build your integration.
Download the skill (poshub-partner-skill.zip)
What it does
- Answers questions about the reseller and application flows, authentication, webhooks, menus, orders and going live, from these docs. It tells you which page each answer comes from.
- Builds your integration as a small Node.js project: the token client, account and location creation, onboarding, catalog sync, menu publish and order handling, with tests that run against a fake POS Hub.
- Maps your data to POS Hub. Share a sample of your catalog or order and it writes the mapping, then checks the result before anything is sent.
- Helps you troubleshoot errors in SIT and walks you through the go-live checklist.
You don't need to write code to use it. The assistant explains each step and asks before it runs anything on your machine.
What you need
- An AI coding agent that supports skills, for example Claude Code.
- A POS Hub developer account with an application in SIT (client ID and secret). Resellers also need a reseller ID and login from POS Hub.
- Node.js 20 or newer. If it isn't installed, the assistant offers to install it and asks you first.
Install
Unzip the skill into your agent's skills folder. For Claude Code:
bash
mkdir -p ~/.claude/skills && unzip poshub-partner-skill.zip -d ~/.claude/skillspowershell
Expand-Archive poshub-partner-skill.zip -DestinationPath "$env:USERPROFILE\.claude\skills"For other agents that support skills, put the poshub-partner folder in that agent's skills folder.
Then open your agent in an empty folder and try:
- "What's the difference between the reseller and application flow?"
- "Set up my POS Hub integration"
Keep your credentials safe
When the assistant needs credentials, it asks you to put them in a .env.sit file yourself. Never paste a client secret, password or token into the chat. The skill contains no POS Hub credentials or private data, only these public docs and the public API structure.
Updating
The skill is rebuilt whenever these docs change. Download it again and replace the poshub-partner folder; projects you have already generated aren't affected. The assistant tells you when a project was made with an older version.
