Agent Skills

Install the HyperTrack skill so Claude Code, 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. Instead of reading through seven install guides and copying snippets by hand, the agent reads the reference for your platform and writes the code against it.

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

Claude Code

Clone the repository into your skills directory.

git clone https://github.com/hypertrack/hypertrack-skills.git ~/.claude/skills/hypertrack-skills

You can also install it through skills.sh.

npx skills add hypertrack/hypertrack-skills

Pi

pi install git:github.com/hypertrack/hypertrack-skills

Other agents

Clone the repository and point your agent at the skill entry point.

skills/hypertrack-integration/SKILL.md

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 works through the integration in phases, starting with account setup and moving through the mobile SDK, the backend, webhooks, and verification. It loads only the reference it needs for your platform, so it does not spend context on the six SDKs you are not using.

skills/hypertrack-integration/
├── SKILL.md                      # Entry point: phases, data model, routing
└── references/
    ├── sdk-ios.md                # iOS SDK setup
    ├── sdk-android.md            # Android SDK setup
    ├── sdk-cross-platform.md     # RN, Expo, Flutter, Ionic, MAUI
    ├── backend-api.md            # Orders, Workers, Places, Nearby, Embed
    ├── webhooks.md               # Webhook setup, payloads, risk events
    └── troubleshooting.md        # Diagnostics, pitfalls, outage codes

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.

On this page