Agent Skills

Install the HyperTrack skill so Claude Code, Codex, Pi, or any coding agent can build your integration end to end.

Introduction

HyperTrack Skills is an agent skill that teaches your coding agent how to integrate HyperTrack. It covers mobile SDK setup, backend APIs, webhooks, and verification. Install it once, then describe what you need in plain language and let the agent write the integration.

A skill is a folder of instructions that your agent loads on demand. This skill directs the agent to fetch the relevant HyperTrack guides, SDK references, and API specification before writing code. The docs remain the source of truth; the skill adds integration decisions, common pitfalls, and verification steps.

Choosing between Skills and the MCP server

The two solve different problems and work well together. The skill gives your agent the knowledge to build an integration. The MCP server gives your agent live data from your account.

	Agent Skills	MCP Server
What your agent gets	Knowledge of how to build the integration	Live data from your account
When to use it	You are writing integration code	You are asking questions about live operations
Example request	"Add HyperTrack to my iOS app"	"Where is worker John right now?"
Requires credentials	No	Yes

If you are building an integration, install both. The skill writes the integration and the MCP server lets you confirm that it works.

Install the skill

Install the skill with skills. It works with Claude Code, Codex, Cursor, Pi, GitHub Copilot, Gemini CLI, OpenCode, and many other agents.

npx skills add hypertrack/hypertrack-skills

The command detects the coding agents you have installed and adds the skill to the current project. Add -g to install it for all your projects instead. To update the skill later, run npx skills update.

To install it by hand instead, copy or symlink the skills/hypertrack-integration folder from the repository into your agent's skills directory.

What the skill covers

Area	Scope
Mobile SDK	iOS, Android, React Native, Expo, Flutter, Ionic Capacitor, and .NET MAUI
Backend APIs	Orders for shift and order tracking, Workers, Places, Nearby search, and embedded views
Webhooks	Setup, payload shapes, order events, risk detection, and geofence events
Verification	End-to-end checklist, diagnostics, common pitfalls, and outage codes

The skill starts by inspecting your repo and settling shared decisions, then guides implementation, verification, and go-live. It fetches the docs needed for your task rather than bundling copies of every platform's setup guide. The agent needs web access to read those sources.

skills/hypertrack-integration/
├── SKILL.md                      # Model, rules, workflow, doc routing
└── references/
    └── testing.md                # API checks, device test protocol, pitfalls

Use the skill

Describe what you need and the skill routes your agent to the right reference. For example:

"Integrate HyperTrack into my iOS app"
"Set up shift tracking with pre-shift risk detection"
"Add HyperTrack order tracking to my Node.js backend"
"Debug why my HyperTrack worker isn't showing on the dashboard"
"Set up webhooks to detect late arrivals"

Collect your credentials from the Setup page before you start. You will need an AccountID and SecretKey for backend API calls, and a Publishable Key for the mobile SDK.

Review what the agent writes

The skill makes your agent faster, but you should still review two things by hand.

Confirm that silent push notifications are configured on every platform you ship. This is the most common reason that tracking never starts, and it is the step most easily skipped.

Check where the SecretKey ended up. It belongs in your backend environment, never in the mobile app and never in a file that is committed to version control.

MCP Server lets an AI assistant query your live account.
Install the SDK contains the hand-written SDK guides that the skill draws on.
hypertrack/hypertrack-skills is the skill repository on GitHub.