Terra API Agent Skills

Install instructions that help AI agents create more accurate Terra API integrations.

Agent skills give AI coding agents reusable guidance for building Terra API integrations. Terra maintained skills provide the newest product and API guidance based on the latest recommended practices. They follow the Agent Skills open standard, so they work with Claude Code, Cursor, GitHub Copilot, Gemini CLI, and any other agent that supports the format.

The same set ships as a plugin for Claude Code, Codex and Cursor. The plugin connects your agent directly to your Terra API account through the Terra CLI, so it can set up, manage and debug your Terra API integration without you clicking through the Terra Dashboard. If the CLI is missing or logged out when a session starts, the agent offers to install it and log you in. It never does either without asking.

Install

Plugin

Claude Code

/plugin marketplace add tryterra/agent-skills
/plugin install terra@terra

Codex

codex plugin marketplace add tryterra/agent-skills

Then pick Terra API in the plugins browser.

Cursor and other Agent Plugin hosts

npx plugins add tryterra/agent-skills

Skills only

The Terra CLI installs the skills and configures every coding agent it finds, so you get the latest set without configuration or maintenance. This is the recommended path.

brew install tryterra/tap/terra   # macOS
npm install -g @tryterra/cli      # everywhere else

terra agent setup

This command detects which agents you use, and writes the skills to the directory each one reads. See Coding agents for the flags that pick an agent, a subset of skills, or a user-wide install.

Or install every skill with skills.sh:

npx skills add tryterra/agent-skills

Or a single skill:

npx skills add tryterra/agent-skills --skill terra-unified-api

Manually installed skills do not update themselves. Run npx skills update -y to get the latest versions.

Included skills

Skill	What it covers	Status
terra-cli	Read and change account configuration from the terminal instead of the dashboard, and reach any endpoint directly	✅ Ready
terra-unified-api	API best practices: webhooks and signature verification, data idempotency, connection lifecycle, multi-device data, testing	✅ Ready
terra-mobile-sdk	Mobile integration for Apple Health, Samsung Health, and Health Connect on iOS, Android, React Native, and Flutter	✅ Ready
terra-streaming	Realtime websocket data and the Real-Time SDK on iOS, Android, React Native, Flutter, and Wear OS	✅ Ready
terra-models	Running health models (Sleep Window, Menstrual Cycle Tracker, Smart Fill) over a connected user's data	✅ Ready
terra-vantage	Blood and DNA test kit ordering, fulfillment tracking, and FHIR result delivery	✅ Ready
terra-planned-workouts	Pushing structured interval workouts, with targets, to wearables	🧪 Pre-release
terra-routes	Pushing GPS courses with waypoints to devices like Garmin, COROS, and Wahoo	🧪 Pre-release
terra-lab-reports	Parsing lab report PDFs and images into standardised biomarkers, with LOINC and UCUM codes	🧪 Pre-release

skills/index.json lists every skill, what it does, and the files it ships. Both terra agent setup and npx skills add read it, so it is the authoritative list.

Contributing

This repository is published automatically from a private source and is read-only: pull requests here cannot be merged. Please report corrections, gaps and bugs as issues.

The Terra API docs are LLM-friendly: append .md to any docs.tryterra.co URL for markdown, or start from docs.tryterra.co/llms.txt.

License

MIT